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ABSTRACT 


This document presents the organization of the Software Engineering Laboratory (SEL) 
database. Included are definitions and detailed descriptions of the database tables and views, 
the SEL data, and system support data. The mapping from the SEL and system support data 
to the base tables is described. In addition, techniques for accessing the database through the 
Database Access Manager for the SEL (DAMSEL) system and via the ORACLE structured 
query language (SQL) are discussed. 
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SECTION 1— INTRODUCTION 


The Software Engineering Laboratory (SEL) was established in 1976 to support research in 
measurement and evaluation of the software development process. Under its sponsorship, 
numerous experiments have been designed and executed to study the effects of applying 
various tools, methodologies, and models to software development efforts in flight dynamics 
applications. The SEL is a cooperative effort of the National Aeronautics and Space 
Administration/Goddard Space Flight Center (NAS A/GSFC), Computer Sciences Corpora- 
tion (CSC), and the University of Maryland. 

To support the research activities it sponsors, one of the major functions of the SEL is the 
collection of detailed software engineering data, describing all facets of the development 
process, and the archival of this data for future use. To this end, the SEL has created and 
maintained an online database for the storage and retrieval of software engineering data. The 
SEL database has been designed and implemented as a relational database under the 
ORACLE relational database management system (RDBMS) on the Systems Technology 
Laboratory (STL) VAX 1 1/780 at GSFC. Since ORACLE provides the facilities for organiz- 
ing, storing, maintaining, and retrieving data, SEL database users do not have to understand 
the physical organization of the data. They need only understand the logical structure of the 
database in order to query, calculate, and manipulate a variety of information. SEL database 
users include those involved in software engineering research, managers of current flight 
dynamics development efforts, and those involved in the collection of SEL data and mainte- 
nance of the database. 

This document is intended as a reference guide for all SEL database users. Its purpose is to 
provide general users with high-level information about data collected by the SEL and how 
they are stored in the database. Information on how to access the data via various access paths 
is also provided. For database maintenance personnel, this document provides in-depth 
information about the structure of the database, including table and field definitions, indexes 
used, and constraints among data items. 

Since this document is intended to be referenced by a broad spectrum of users, it is organized 
in increasing levels of specification. Section 1 . 1 describes general relational database con- 
cepts and terminology for readers who are not familiar with relational database systems. 
Section 2 of the document presents an introduction to the types of data that are stored from a 
conceptual point of view (i.e., without regard to physical or logical storage characteristics). 
Section 3 discusses the organization of the data with respect to their sources and the form in 
which they are collected. The conceptual view in Section 2 and the data collection view in 
Section 3 are then mapped into a logical view of the database design. This design is presented 
in Section 4. The logical design of the database is the lowest level of detail required to 
understand how to access the database. Details of the physical implementation are hidden 
from the user via the ORACLE RDBMS. Section 5 discusses various ways to actually access 
the SEL database. Appendix A lists all codes used in the database: Appendix B presents 
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sample database queries; Appendix C presents the SEL data collection forms; and Appen- 
dix D contains the data definition language (DDL), which specifies the definitions and 
constraints of the database tables and views. 

1.1 BASIC RELATIONAL DATABASE CONCEPTS 

In relational database terminology, the basic structure for storing items of data is the table, or 
relation. A table consists of a variable number of rows. There is no predefined order in which 
the rows of a table are stored. Each row consists of a fixed number of columns, or fields. 
Columns are identified by column names and are defined to contain values of a specific data 
type (e.g., character, number, date). A particular column or group of columns is defined as a 
unique index for the table. This means that the values of those columns will be unique for 
every row in the table. There may also be other columns that are indexed but do not have to be 
unique across all rows. Certain columns exist only to define the relationship of a given row to 
rows in other tables. If the values in a column from one table are drawn from the same domain 
as the values in a column from another table, the data in the two tables are related where rows 
in each table share a common value. This basic organization is illustrated in Figure 1-1. 

Figure 1-1 contains two tables, PROJECT and PROJ_SUB. The row in the PROJECT table 
for the project named XYZ is related, via common values in the project number columns 
(PROJ_NO), to a group of rows in the PROJ_SUB table representing XYZ’s subsystems. 
The primary key in the PROJECT table is the project name column (PROJ_NAME), while 
the primary key in the PROJ_SUB table is the combination of the project number 
(PROJ_NO) and the subsystem prefix (SUB_PRE) columns. For more details. Reference 6 
provides a good overview of relational database concepts. For ORACLE-specific informa- 
tion, References 4 and 5 provide an overview of the ORACLE RDBMS as well as a detailed 
description of the ORACLE structured query language (SQL). 

Previous versions of this document mentioned that the SEL database contained clusters. The 
SEL database no longer has any clusters and all reference have been removed. 
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TABLE: PROJECT 
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TABLE: PROJ SUB 


PROJ NO SUB_PRE SUB DATE 



Figure 1-1. Basic Relational Database Organization 
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SECTION 2 — A CONCEPTUAL VIEW OF SEL DATA 


This section presents an overview of the types of software engineering data that are stored in 
the SEL database from a conceptual point of view. The fundamental entity about which SEL 
data are collected and stored is the project. Project data compose the bulk of the data in the 
database and are presented in Section 2.1. A relatively small portion of the database is 
allocated to the storage of support data, such as computer and personnel names. These data, 
which are not associated exclusively with individual projects, are referred to as project-inde- 
pendent data throughout this document. Section 2.2 contains detailed descriptions of these 
data. The data elements described in this section are tagged with the reference identifiers 
used in Sections 3 and 4. 

Figure 2-1 shows the major data items that make up both the project data and the project- 
independent data. This conceptual view of the data is later mapped into the logical view of the 
SEL database discussed in Section 4. In the figure, data items flagged with asterisks are 
collected both during development and maintenance stages. The rest are collected only in 
projects’ development stages. 

2.1 PROJECT DATA 

Software development in the area of flight dynamics at GSFC is performed in distinct units 
referred to by the SEL as projects. A project exists for a specified period of time that spans the 
life of a particular software product. The life of a project comprises two primary stages: the 
development stage and the operations and maintenance stage. The majority of the data 
collected by the SEL cover the development stage of the lifespan, although some data, such 
as resources and changes, are also collected during the maintenance stage. The following 
sections describe data types that characterize the development stage as well as data types that 
are captured during the maintenance stage. In addition, each project has associated with it the 
following general information that defines and identifies the project. 

PI Name of the project; a unique identifier distinguishing it from other projects 

P2 Type of project; indicator used to describe the nature of the application and to 
identify projects with similar applications for the purpose of comparison 

P3 Current status of the project; whether it is in the development stage or the 
maintenance stage or whether its life cycle has been completed or discontinued 

P4 Miscellaneous descriptive information; this is optional data and may include any 
of the following: 

• Project’s full name 

• Contacts for the project 
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Figure 2-1. Conceptual View of SEL Data 






• Language(s) used in a project 

• Computer on which project is being developed and operated 

• Computer accounts to be monitored by the SEL 

• Project task numbers and corresponding years 

• SEL forms collected for the project 

• General notes on project or data peculiarities 

• Name of the project controlled source library 

• Tools used for collecting project growth data 

• Project closeout status 

• Types of data that are currendy stored in the database for the project 

2.1.1 Schedules 

Project schedules divide the lifespan of a project into a series of nonoverlapping, contiguous 
time periods referred to by the SEL as phases. During the development stage, the phases 
correspond closely to the primary type of development activity being performed at any given 
time. The transition from one phase to the next is signaled by project milestones, such as the 
critical design review (CDR). The schedules stored in the database are supplied by personnel 
involved in managing the projects being monitored. An initial schedule is submitted at the 
start of the project and updated every 6 to 8 weeks thereafter until the completion of the 
project’s development stage. All schedules submitted are stored in the database along with 
their submission dates to provide a historical trace of schedule changes. Schedule data exist 
in sets that include the following: 

PI Project name 

P5 Date on which the schedule was recorded 

P6 Requirements definition phase start and end dates 
P7 Design phase start and end dates 

P8 Implementation (code and test) phase start and end dates 
P9 System test phase start and end dates 

P10 Acceptance test phase start and end dates 

Pll Cleanup phase start and end dates 

P12 Maintenance stage start and end dates (not collected on current Project Esti- 
mates Form (PEF), but data exist for some projects) 
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Phase dates are subject to certain constraints, such as the requirement that they always fail on 
a Saturday. Also, depending upon the life-cycle model followed, the size and level of 
formality of the project, and the SEL’s research needs, some of the phase dates may not be 
supplied for particular projects. Reference 1 presents a more thorough discussion of the SEL 
definition of phase dates and the constraints to which they must adhere. 

2.1.2 Estimates 

At various points in the life of a project, estimates are made of certain project characteristics 
whose actual values do not become available until the end of the development phase. These 
projections are made as part of the process of planning the project and monitoring its 
progress. As the project proceeds, the estimates are updated regularly to reflect such factors 
as system growth and changes in staffing patterns. Thus, toward the end of the development 
phase, the at-completion estimates converge on the actual final project characteristics. The 
sets of estimates collected by the SEL and stored in the database include the following: 

PI Project name 

P13 Date on which the set of estimates was recorded 

P14 Number of subsystems in the software product 

P15 Number of components in the software product 

P16 Total source lines of code (SLOC) in the software product 

P17 Total SLOC for all reused components in the software product 

P18 Total SLOC for all modified components in the software product 

P19 Total SLOC for all new components in the software product 

P20 Programmer hours spent on the project 

P21 Management hours spent on the project 

P22 Services hours spent on the project 

The terms “subsystem” and “component,” used above and elsewhere in this document, have 
specific definitions in the SEL environment. In general, subsystems are a mutually exclusive 
partitioning of the components that constitute a software system. Components, or modules, 
are individual routines that are maintained in separate files. (See Reference 1 for a more 
detailed description of these concepts.) 

The SLOC estimates refer to total lines of source code, including executable and nonexecut- 
able statements, comments, and blank lines. The total lines estimate is expected to be the sum 
of the old, modified, and new lines estimates. The programmer hours estimate is a projection 
of the total technical effort to be spent on the project. Similarly, the management hours 
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estimate is a projection of the total hours to be charged to project management. The services 
hours estimate is a projection of the hours to be spent by support personnel on the project. 
This includes secretaries, technical editors, word processors, couriers, and project control 
personnel. 

2.1.3 Resource Use 

Throughout the development stage of a project, the use of personnel and computer resources 
is measured and stored on a weekly basis. However, only the personnel resource use is 
measured when a project starts its maintenance phase. 

2.13.1 MANPOWER 

Development 

Each week, the staff resources expended on a given project are recorded and stored in the 
database. Hours are stored for each person who does technical work or directly manages the 
project during the particular week in question. These hours are categorized by the type of 
development activity being performed. Thus, for any given project, week, and programmer, 
the following data are stored: 

PI Project name 

P23 Week ending date; this date is always a Friday 

P24 Personnel name; name of the person performing technical or direct management 

work on the project 

P25 Predesign hours; hours worked on the project before commencement of actual 
design work (requirements definition, requirements analysis, etc.) 

P26 Create design horns; hours spent performing software design activities (creating 
structure charts, writing program design language (PDL), etc.) 

P27 Read and review design hours; hours spent reading and reviewing design materi- 

als (peer reviews, design walkthroughs, etc.) 

P28 Write code hours; hours spent developing source code from design materials 
(coding at desk, entering code at terminal, etc.) 

P29 Read and review code hours; hours spent reading code for any purpose except 
isolation of errors (peer review, code walkthroughs, desk checks, etc.) 

P30 Test code unit hours; hours spent testing individual code units (planning and 
executing test cases, writing test drivers and stubs, etc.) 

P31 Debug hours; hours spent isolating errors and planning corrections (does not 
include actually correcting errors) 

P32 Integration test hours; hours spent planning tests that integrate system 
components (writing and executing system tests, etc.) 
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P33 Acceptance test hours; hours spent running and supporting acceptance testing of 
the software 

P34 Other hours; hours that do not fall into any of the above activities (management, 

training, documentation, etc.) 

The hours that are recorded in the various activities for a given programmer during a given 
week add up to the total hours worked on the project during that week by that programmer. 
Manpower hours are recorded to the nearest tenth of an hour. For projects that began before 
June 1987, the activity hour items P25 through P34 may be further classified by being 
associated with the subsystem on which the work was performed. In this case, the sum of the 
hours recorded in the various activities and associated with particular subsystems plus the 
hours charged to various activities and not associated with particular subsystems represents 
the total hours worked during that week by that programmer. An example of the latter case is 
as follows: 



In addition to and independent of these activity hours, programmer hours for the week are 
collected for the following activities: 

P35 Rework hours; hours spent reworking any part of the system due to errors or 
other unplanned changes (includes rework of code, design, testing, and all hours 
spent debugging) 

P36 Enhancing, refining, and optimizing hours; hours spent improving efficiency or 

clarity of design, code, or documentation (not due to unplanned changes) 

P37 Documenting hours; hours spent creating any form of documentation on the 
system (system descriptions, user’s guides, in-line comments, etc.) 

P38 Reuse hours; hours spent attempting to reuse components of this or other 
systems 

The hours recorded in the above categories do not adhere to the constraint that their sum must 
represent the total hours worked by a given programmer during a given week. 

Certain projects in the database were developed using a cleanroom methodology. Conse- 
quently, the types of development activities recorded for these projects are different from 
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those mentioned above. However, staff resources expended on these projects are still re- 
corded weekly and hours are still stored for each person who does technical work or directly 
manages the project. The following are the data stored for projects using a cleanroom 
methodology: 

PI Project name 

P23 Week ending date; this date is always a Friday 

P24 Personnel name; name of the person performing technical or management work 

on the project 

P 1 57 Predesign hours; hours worked on the project prior to the actual design (such as 

requirement analysis, etc.) 

P 1 58 Pretest hours; hours worked on developing test plans and building test environ- 

ments (compiling components, building libraries, defining input, etc.) 

PI 59 Create design hours; hours spent developing system, subsystems, or 

components design (state machine representation, data and stepwise refinement, 
PDL, etc.) 

P 1 60 Verify and review design; hours spent verifying and reviewing design in a group, 
including design meetings, formal and informal reviews, or walkthroughs 

P161 Write code hours; hours spent coding system components (coding at desk, 
entering code at terminal, etc.) 

P162 Read and review code hours; hours spent reading code for any purpose other 
than isolation of errors (code verification) 

P163 Independent test hours; hours spent generating and executing tests of system 
components (by independent tester) 

P 1 64 Response to software failure report (SFR) hours; hours spent resolving a tester- 
reported problem (isolating a reported problem and developing a solution) 

P 1 65 Acceptance test hours; hours spent running and supporting acceptance testing of 

the software 

P166 Other hours; hours spent on activities not covered above (management, 
meetings, training, documentation, etc.) 

In addition to and independent of these cleanroom development activity hours, any weekly 
programmer hours spent understanding the methodology are captured under the following 
category: 

P 167 Methodology Understanding and Discussion; hours spent learning, discussing, 
or receiving training in cleanroom-related methods and techniques 

Reference 1 presents a more detailed discussion of the various activities that categorize 
manpower effort hours. 
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Maintenance 


When a project completes its development cycle and starts its maintenance stage, the use of 
personnel resources is also measured and stored. Each week, the regular maintainers’ re- 
sources expended on a given maintenance project are recorded. Hours are stored for each 
person who does technical work or directly manages the project. The hours are categorized 
by both the class of maintenance and by the type of activity being performed. Thus, for any 
given maintenance project, the following data are stored: 


PI 

P23 

P24 

P168 

P169 

P170 

P171 

P172 

P173 

P174 

P175 

P176 

P177 

2.13.2 


Project name 

Week ending date; this date is always a Friday 

Personnel name; name of the person performing technical or management work 
on the maintenance project 

Correction class hours; hours worked on all maintenance associated with a 
system failure 

Enhancement class hours; hours spent on all maintenance associated with 
modifying the system due to a requirements change 

Adaptation class hours; hours spent on all maintenance associated with modify- 
ing a system to adapt a change in hardware, software, or environment 
characteristics 

Other class hours; hours spent on all maintenance that do not fall into any of the 
above classes (management, meetings, etc.) 

Isolation activity hours; hours spent on understanding the failure or request for 
enhancement or adaptation 

Change design activity hours; hours spent on redesigning the system 

Implementation activity hours; hours spent on changing the system to complete 
the necessary change (hours include changing not only the code, but the 
associated documentation as well) 

Unit or system test activity hours; hours spent on testing the changed or added 
component 

Acceptance or benchmark test activity hours; hours spent on acceptance or 
benchmark testing 

Other activity hours; hours that do not fall into any of the above activities 
(management, meetings, etc.) 

SERVICES 


Each week during the development stage of a project, services hours are recorded and stored 
in the database. These are hours spent by support personnel who are not directly involved in 
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the technical aspects of the project. The categories of services hours recorded each week for a 
given project are as follows: 

PI Project name 

P23 Week ending date; this date is always a Friday 

P39 Technical publications hours; hours spent by technical editors, word processors, 

graphic artists, etc., in preparing technical documentation for the project 

P40 Secretary hours; hours spent by secretarial personnel in direct support of the 
project 

P41 Librarians; hours spent by data librarians in support of the project, e.g., data 
entry, tape generation (not collected on current Service/Products Form (SPF) 
but data exist for some old projects) 

P42 Project management; hours spent by persons performing management activities 

in support of the project, but who are not directly responsible for the project’s 
management 

P43 Other; hours spent in support of the project by personnel who do not qualify in 
one of the support service categories above 

Service hours are not recorded for individuals. Rather, the sum of the hours reported by all 
persons performing a particular support activity during a given week is recorded. 

2.133 COMPUTER 

Computer resources are the third type of resource data recorded and stored in the database on 
a weekly basis. During the portion of the development stage when programmers are using 
computer resources to create the resulting software product, the number of computer runs 
and central processing unit (CPU) hours used are monitored. If different portions of the 
development effort are performed on different machines, hours and runs are recorded for 
each of them. Thus, for each week of a given project, the following computer resource data 
are stored: 

PI Project name 

P23 Week ending date; this date is always a Friday 

and for each computer being used at the current time: 

P44 Computer name; name uniquely identifying the development computer 

P45 CPU hours used 

P46 Number of runs executed 
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The number of runs recorded is measured as either the number of interactive logons by 
project members, the number of batch jobs submitted by project members, or both. On some 
development computers, the accounting reports used for obtaining the resource data show 
separate CPU time and number of run statistics for interactive sessions and batch jobs. In 
these cases, the two are recorded separately under distinct computer names. On other ma- 
chines, the accounting reports show total CPU time and number of runs without distinguish- 
ing between batch jobs and interactive sessions. In these cases, only the single combined 
figures are recorded. 

2.1.4 Product Characteristics 

A fourth class of project-related data characterizes the software product that is generated 
during the development stage. There are two primary types of product data: that which 
captures the static composition of the system at any given point in time, and that which 
captures the dynamic properties of system growth and change. 

2.1.4.1 STRUCTURE AND SIZE 

The static composition of the system is recorded as the system is produced. This consists of 
the partitioning of the system into subsystems and components, along with descriptive 
information about each. As mentioned earlier, the SEL defines subsystems as a mutually 
exclusive partitioning of the system components. For each subsystem in a project, the 
following data items are stored: 

PI Project name 

P47 Subsystem prefix; mnemonic prefix used in naming components that belong to 
the subsystem 

P48 Subsystem name; descriptive name describing the purpose of the subsystem 

P49 Subsystem function; indicator used to describe the nature of the subsystem and 
also to identify similar subsystems for the purpose of comparison 

P50 Date on which the subsystem information was recorded 

Subsystem prefixes are unique within a given project. Each subsystem comprises multiple 
components. Components are defined as modules or routines that are maintained in separate 
files as individual configuration items. Each component is associated with exactly one 
subsystem. The following descriptive information is stored for each component of the 
system: 

P24 Programmer name; name of programmer who created the component 
PI Project name 

P47 Subsystem prefix; prefix identifying the subsystem to which the component 
belongs 
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P51 Component name; descriptive name used in identifying the component 

P52 Component date; date on which the component information was recorded by the 

programmer 

P53 Creation date; date on which the component first became part of the system 
configuration (i.e., was moved into the controlled source library) 

P56 Origin; source of the component (i.e., old code, modified old code, new code) 

P57 Difficulty; discrete rating on a scale of 1 (easiest) to 5 (most difficult) of the 

difficulty in creating the component 

P58 Type; indicator used to classify components of similar nature for comparison 

P59 Purpose; indicator of the component’s purpose 

2.1.4.2 GROWTH 

Growth data recorded in the SEL database capture the dynamic nature of the evolving 
software product. These data are obtained by taking snapshots of the controlled source 
library of the project at regular intervals (weekly for development projects, monthly for 
maintenance projects). The data elements captured each week provide a historical perspec- 
tive on system size through the development stage of the life cycle. The information recorded 
is as follows: 

PI Project name 

P23 Week ending date; this data is always a Friday 

P60 Lines of code; count of the total lines of code in the project’s controlled source 

library 

P61 Components; count of the number of components in the project’s controlled 
source library 

P62 Changes; count of the number of changes that have occurred in the project’s 
controlled library (each time a new component is added to the library, it is 
counted as one change; each time a component is updated in the library, it is 
counted as another change) 

2.1.5 Changes 

Development 

Detailed information is recorded in the database for each change that takes place in a 
project’s configured software library (or libraries). A change is viewed by the SEL as an 
update to one or more system components for a particular specific purpose. Typical purposes 
for changes include correcting an error, improving the efficiency of a particular operation, or 
implementing an enhancement. The following data items are stored for each change: 
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PI Project name 

P63 Change number; number uniquely identifying each change in the database 

P24 Programmer name; name of the programmer implementing the change 

P65 Change date; date on which the change information was recorded 

P66 Effort required to isolate the change; time spent determining what was necessary 
to make the change 

P67 Effort required to implement the change; time spent actually designing, coding, 
and testing the change 

P68 One component affected; flag indicating whether the change involved updating 

only one component 

P69 Involved Ada; flag indicating whether the change resulted from using the Ada 
language 

P70 Examined other components; flag indicating whether components other than 
those changed were examined when performing the change 

P71 Parameters passed; flag indicating whether the change required awareness of 
data communicated between components 

P72 Date change determined; date on which the need for the change was initially 
determined 

P73 Date change completed; date on which the change was implemented into the 
system 

P74 Number of components changed; count of the changed components 

P75 Number of components examined; count of the components examined in the 
change process that were not changed themselves 

P76 Change type; indicator used to classify changes by particular types 

P77 Error source; indicator of the source of the error for changes where the change 

type (P76) is error correction 

P78 Error class; indicator of the class of error for changes where the change type 
(P76) is error correction 

P79 Commission error; for changes where the change type (P76) is error correction, 
flag indicating whether something incorrect was included in the code 

P80 Omission error; for changes where the change type (P76) is error correction, flag 

indicating whether something was left out of the code 
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P81 Typographical error; flag indicating whether an error was typographical in 
nature for changes where the change type (P76) is error correction 

P82 Ada documentation; flag indicating whether the Ada documentation clearly 
explained the features that contributed to an error (P76) attributed to the use of 
Ada (P69) 

P83 Ada cause; indicator of the cause of an error (P76) attributed to the use of Ada 
(P69) 

P84 Changed components; subsystem prefixes and names of the components that 
were changed 

P85 Ada features; list of the Ada features that were involved in a change (P76) in 
which the use of Ada was a contributing factor (P69) 

P86 Ada resources; list of resources used in resolving an Ada-related error (P69,P7 6) 

P87 Ada tools; list of software tools used in resolving an Ada-related error (P69,P7 6) 

Maintenance 

Detailed information is also recorded for each change that takes place in a project’s con- 
trolled library during the maintenance stage. The definition of change is the same as men- 
tioned in the change (development) section. The following data items are stored for each 
change: 

PI Project name 

P24 Programmer name; name of the programmer implementing the change 

P65 Change date; date on which the change information was recorded 

P178 Operational Software Modification Report (OSMR) number 

P179 Change type; indicator used to classify changes by particular types 

P180 Change cause; indicator used to classify the cause of a particular change 

P 1 8 1 Effort required to isolate the change; time spent determining what was necessary 

to make the change 

P182 Effort required to implement the change; time spent actually designing, coding, 
and testing the change 

PI 83 Changed object types; list of objects that have been changed as a result of this 

change 

P184 Change characteristic; indicator used to classify the characteristic of this change 
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P185 Number of SLOC that have been newly added (the total SLOC includes blanks 
and comments) 

PI 86 Number of SLOC that have been modified 

PI 87 Number of SLOC that have been deleted 

PI 88 Number of components that have been newly added 

PI 89 Number of components that have been modified 

PI 90 Number of components that have been deleted 

P191 Number of the added components that are totally new 

PI 92 Number of the added components that are totally reused 

PI 93 Number of the added components that are reused with modifications 


2.1.6 Subjective Evaluations 

When a project completes its development stage, the retrospective subjective opinions of 
personnel involved in the management of the project are collected and stored in the database. 
This includes rating a set of project characteristics on a scale of 1 to 5 and indicating what 
software engineering tools were used on the project. Unless otherwise specified, the scale on 
the measures ranges from 1 = low to 5 = high. The subjective data items recorded are as 
follows: 

PI Project name 

P88 Problem complexity 

P89 Schedule constraints (loose = 1, tight = 5) 

P90 Stability of requirements (unstable = 1, stable = 5) 

P91 Quality of requirements 

P92 Documentation requirements 

P93 Rigor of requirements reviews 

P94 Development team ability 

P95 Development team application experience 

P96 Development team environment experience 

P97 Stability of development team (unstable = 1, stable = 5) 

P98 Management performance 
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P99 Management application experience 

P100 Stability of management team (unstable = 1, stable = 5) 

P101 Project planning discipline 
PI 02 Degree to which plans were followed 
P103 Use of modem programming practices 
P104 Discipline in formal communication 

P105 Discipline in requirements methodology 

PI 06 Discipline in design methodology 

PI 07 Discipline in testing methodology 

PI 08 List of tools used on project (not a numerical rating, but an actual list of tool 
names) 

P109 Use of test plans 

Pi 10 Discipline in quality assurance 

Pill Discipline in configuration management 

Pi 12 Access to development system 

P113 Ratio of developers to terminals (low = 5, high = 1) 

PI 14 Memory constraints 

PI 15 System response time (poor = 1, very good = 5) 

PI 16 Stability of hardware and support software 

PI 17 Effectiveness of tools used 

PI 18 Agreement of software with requirements 

P119 Quality of software 

PI 20 Quality of design 

P121 Quality of documentation 

PI 22 Timeliness of delivery 

P123 Smoothness of acceptance testing 

2.1.7 Final Statistics 

When the development stage of a project is complete, the actual values of parameters that 
were estimated earlier and of additional parameters that were not estimated are recorded. In 
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addition, the project source code is run through a static analysis tool, and statistics are 
recorded for each component of the system. The data items that constitute final project 
statistics are as follows: 

PI Project name 

P 1 24 Date on which the final statistics were recorded 

PI 25 Actual requirements definition phase start and end dates 

PI 26 Actual design phase start and end dates 

PI 27 Actual code and test (implementation) phase start and end dates 
PI 28 Actual system test phase start and end dates 
PI 29 Actual acceptance test phase start and end dates 
PI 30 Actual cleanup phase start and end dates 
P 1 3 1 Maintenance stage start and end dates 

P 1 32 Total technical and management hours expended on the project 
PI 33 Total service hours expended on the project 
PI 34 Computer name 
PI 35 CPU hours used 

P 1 36 Number of runs executed, for each computer used on the project 

PI 37 Number of subsystems in the system 

P138 Number of components in the system 

PI 39 Number of changes made to system components 

PI 40 Number of pages of documentation produced for the system 

P141 Total SLOC for all components in the system 

PI 42 Total SLOC for all components in the system that were classified as new 

P143 Total SLOC for all components in the system that were classified as slightly 
modified 

P2 1 3 Total SLOC for all components in the system that were classified as extensively 
modified 

PI 44 Total SLOC for all components in the system that were reused from other 
systems without modification 
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P145 Total number of comment lines for all components in the system 

P146 Total number of executable components in the system 

P147 Total number of newly created executable components in the system 

P148 Total number of executable components in the system that were obtained from 

other systems and slightly modified for this project 

P214 Total number of executable components in the system that were obtained from 
other systems and extensively modified for this project 

P149 Total number of executable components in the system that were reused from 
other systems without modification 

PI 50 Total number of executable statements for all FORTRAN components in the 
system 

PI 51 Total number of executable statements for all FORTRAN components in the 

system that were classified as new 

PI 52 Total number of executable statements for all FORTRAN components in the 
system that were classified as slightly modified 

P215 Total number of executable statements for all FORTRAN components in the 
system that were classified as extensively modified 

PI 53 Total number of executable statements for all FORTRAN components in the 
system that were reused from other systems without modification 

P216 Total number of statements for all components in the system 

P217 Total number of statements for all components in the system that were classified 
as new 

P218 Total number of statements for all components in the system that were classified 
as slightly modified 

P219 Total number of statements for all components in the system that were classified 
as extensively modified 

P220 Total number of statements for all components in the system that were reused 
from other systems without modification 

and for each component in the system: 

PI 54 Number of executable statements in the component (for FORTRAN 
components only) 

PI 55 Number of SLOC in the component (includes comments and blank lines) 
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PI 56 Number of comment lines in the component (for FORTRAN or Ada 
components only; does not include blank lines) 

P221 Number of statements in the component (for FORTRAN or Ada components 
only) 

P222 Final origin category assigned to the component 

2.1.8 Development Status Data 

The status of active projects is monitored throughout project development and recorded in 
the SEL database. The data items are recorded on a biweekly basis for each active project. 
There are two types of development status data: target data and measurement data. The target 
data represent the goal or target value. The measurement data represent a value measuring 
the progress toward the target value. The following data items are stored: 

PI Project name 

P23 Week ending date; this date is always a Friday 
P24 Name of originator 

PI 95 Total number of components to be designed 

PI 96 Number of components designed as of the week ending date 

P197 Total number of components to be coded 

PI 98 Number of components coded as of the week ending date 

PI 99 Total number of separate system tests planned 

P200 Number of system tests executed at least one time 

P201 Number of system tests passed 

P202 Total system test runs, including reruns (not collected on current Development 
Status Form (DSF), but data exist for some projects) 

P203 Total number of separate acceptance tests planned 

P204 Number of acceptance tests executed at least one time 

P205 Number of acceptance tests passed 

P206 Total acceptance test runs, including reruns (not collected on current DSF, but 
data exist for some projects) 

P207 Total number of discrepancies reported 
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P208 Total number of discrepancies resolved 

P209 Total number of specification modifications received 

P210 Total number of specification modifications completed 

P211 Total number of requirements questions submitted 

P212 Total number of requirements questions answered by analysts 

2.2 PROJECT-INDEPENDENT DATA 

This section describes two types of data stored in the database that represent real-world 
entities, yet are not directly related to a particular project, as were the items in the previous 
section. The data stored about these items are not extensive. Rather, their primary function is 
to identify specific instances of resources when recording project data. 

2.2.1 People and Services 

The first class of support entities consists of people and services. Each person for whom data 
are recorded is represented in the database by the following data items: 

Ml Form name; abbreviated version of the person’s name used on data collection 
forms (see Section 3) 

M2 Full name; person’s complete first and last name 

M3 Entry date; date on which personnel information was entered into the database 

Service personnel are stored in the database generically; that is, the same information listed 
above is stored as only one generic entry for a given class of service personnel. Thus, for 
example, the personnel entry for secretary refers collectively to anyone performing secre- 
tarial work on a monitored project. 

2.2.2 Computer 

The other class of support entities is computers. Each computer for which resource hours and 
runs are recorded is represented in the database by the following data items: 

M4 CPU name; abbreviated version of the computer name used on data collection 
forms (see Section 3) 

M5 Computer full name; longer, more descriptive name for the computer 
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SECTION 3— SEL DATA FROM A DATA COLLECTION 

VIEWPOINT 


This section describes the data collection forms in their role as sources for the data items 
described in Section 2. Many data items entered on the forms map directly to items described 
in Section 2. Other items (e.g., form numbers) are unique to the data collection process and 
therefore do not appear in Section 2. This section maps the software engineering items in 
Section 2 to their sources on data collection forms and describes the data items that are 
peculiar to the data collection process. 

The following subsections present descriptions for the SEL data collection forms. The data 
items described are tagged with reference identifiers corresponding to the identifiers in the 
forms that are presented in Appendix C. The identifiers are also used as cross references in 
the SEL database access paths (Table 4-4 in Section 4). If an item maps directly to an item in 
Section 2, the description consists of the item name followed by the Section 2 identifier for 
that item (in parentheses). Otherwise, a more complete description is presented. 

3.1 DATA COLLECTION FORMS 

3.1.1 Schedule and Estimates Forms 

The PEF (Figure C-8 in Appendix C) provides periodic estimates of the development 
process and the software product and estimates of the project schedule. The estimates of the 
development process consist of staffing projections. The estimates of the software product 
involve various estimates of the size of the delivered software. The schedule information 
consists of a set of dates on which the various life -cycle phases of the project are scheduled to 
start, along with a projected project end date. These estimates reflect the project size and 
resource expenditure as of the completion of the cleanup phase. 

The PEF is completed by the project leader. It is submitted at the initial entry of the project 
into the database and every 6 to 8 weeks thereafter through the development life cycle. The 
PEF data fields are described below. Note that the phase date fields contain the start dates of 
each of the listed life-cycle phases that apply to the project. The end date for a given phase is 
the next phase start date entered on the form, or the project end date if there are no start dates 
for subsequent phases. 

PEF Fields 

D1 Project name (PI) 

D2 Form date (P5, PI 3) 

D3 Requirements; estimated requirements definition phase start date (P6) 

D4 Design; estimated design phase start date (P7) 
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D5 Implementation; estimated implementation (code and test) phase start date (P8) 
D6 System test; estimated system test phase start date (P9) 

D7 Acceptance test; estimated acceptance test phase start date (P10) 

D8 Cleanup; estimated cleanup phase start date (Pll) 

DIO Project end; estimated project end date 

D 1 1 Programmer hours (P20) 

D 1 2 Management hours (P2 1 ) 

D13 Services hours (P22) 

D14 Number of subsystems (PI 4) 

D15 Number of components (P15) 

D16 Total SLOC (P16) 

D17 Total SLOC for all new Components (P19) 

D18 Total SLOC for all modified components (P18) 

D19 Total SLOC for all reused components (PI 7) 

D20 PEF form number; unique identifier distinguishing this form from other PEFs 

3.1.2 Weekly Rate Data Forms 

The Personnel Resource Form (PRF) or the Cleanroom Personnel Resource Form (CLPRF) 
and the SPF provide weekly rate information for the projects in their development stage. The 
SPF is also used to provide monthly growth rate information for projects in the maintenance 
stage. The Weekly Maintenance Effort Form (WMEF) provides weekly rate information 
when a project starts its maintenance stage. The PRF and CLPRF (Figures C-5 and C-6), 
capture the actual technical/management expenditure history on the project. These forms 
also contain information on the type of activity on which the manpower hours were spent 
during the week. A separate section of the forms is used to record hours spent performing 
specific activities that are of current interest to the SEL. 

The PRF is used to capture personnel hours for most of the SEL-monitored projects. It is 
submitted by every person performing either technical or management activities on the 
project. This form is completed every Friday for the duration of the project development life 
cycle. 

PRF Fields 

D21 Personnel name (P24) 

D1 Project name (PI) 

D22 Week ending date (P23) 
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D23 Predesign hours (P25) 

D24 Create design hours (P26) 

D25 Read/review design hours (P27) 

D26 Write code hours (P28) 

D27 Read/review code hours (P29) 

D28 Test code unit hours (P30) 

D29 Debugging hours (P31) 

D30 Integration test hours (P32) 

D31 Acceptance test hours (P33) 

D32 Other hours (P34) 

D33 Rework hours (P35) 

D34 Enhancing/refining/optimizing hours (P36) 

D35 Documenting hours (P37) 

D36 Reuse hours (P38) 

D37 PRF form number; unique identifier distinguishing this form from other PRFs 

The CLPRF is submitted by personnel who work on projects that use cleanroom methodolo- 
gy to do software development. This form is submitted by every person performing either 
technical or management activities on the project. This form, like the PRF, is completed 
every Friday for the duration of the project development life cycle. 

CLPRF Fields 

D21 Personnel name (P24) 

D 1 Project name (PI) 

D22 Week ending date (P23) 

D199 Predesign hours (P157) 

D200 Pretest hours (PI 58) 

D201 Create design hours (PI 59) 

D202 Verify /review design hours (PI 60) 

D203 Write code hours (PI 61) 
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D204 Read/review code hours (PI 62) 

D205 Independent test hours (PI 63) 

D206 Response to SFR hours (PI 64) 

D207 Acceptance test hours (PI 65) 

D208 Other hours (PI 66) 

D209 Methodology understanding/discussion (P167) 

D210 CLPRF form number; unique identifier distinguishing this form from other 
CLPRFs 

The WMEF (Figure C-14) is submitted by every person performing either technical or 
management activities on a maintenance project. The form is completed every Friday for the 
duration of the project ’s maintenance phase. In the WMEF, the activity hours are categorized 
as class of maintenance hours and as maintenance activity hours. The sum of the class of 
maintenance hours recorded in Section B is equal to the total hours provided in Section A of 
the form. The sum of the maintenance activities hours of Section C is also equal to the total 
hours provided in Section A. The users can choose one of the two categories to calculate the 
total maintenance manpower hours for the project. 

WMEF Fields 

D21 Personnel name (P24) 

D1 Project name (PI) 

D22 Week ending date (P23) 

D151 Correction hours (PI 68) 

D 1 5 2 Enhancement hours (P 1 69) 

D153 Adaptation hours (PI 70) 

D154 Other hours (P 171) 

D155 Isolation hours (PI 72) 

D156 Change design hours (PI 73) 

D157 Implementation hours (PI 74) 

D158 Unit test/system test hours (P175) 

D159 Acceptance/benchmark test hours (P176) 

D160 Other hours (PI 77) 

D161 WMEF form number; unique identifier distinguishing this form from other 
WMEFs 
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The SPF (Figure C-ll) measures resource expenditure by support personnel, and computer 
resource utilization, and is used to create a historical record of product growth over the 
course of the project. The SPF is completed by SEL data collection personnel. The form 
contains three distinct types of data; the growth history data are obtained by running growth 
history monitoring programs on the Flight Dynamics Facility (FDF) mainframes (two 
ES/9000s and two NAS 8063s) and the STL VAX Cluster (8820, 11/780, and Micro VAX 
3100). The computer information is taken from computer accounting reports from these 
computers. Services hours are obtained from task accounting reports. This form is submitted 
every week in which support service or computer resources are used or in which product 
growth data are available. This form is submitted monthly for all maintenance projects for 
which growth data is being monitored. 

SPF Fields 

D1 Project name (PI) 

D22 Week ending date (P23) 

D38 Computer name (P44) 

D39 CPU hours (P45) 

D40 Number of runs (P46) 

D41 Number of components (P61) 

D42 Number of changes (P62) 

D43 Lines of code (P60) 

D44 Technical publications hours (P39) 

D45 Secretary hours (P40) 

D47 Project management hours (P42) 

D48 Other hours (P43) 

D49 SPF form number; unique identifier distinguishing this form from other SPFs 

3.1.3 Product Data Forms 

The Subsystem Information Form (SIF), the Component Origination Form (COF), and the 
Change Report Form (CRF) provide product data information for the project during its 
development stage. The Maintenance Change Report Form (MCRF) provides product data 
information for the project when it moves into its maintenance stage. 

The SIF (Figure C- 13) contains information about the high-level partitioning of the system 
into subsystems. A subsystem prefix, a descriptive name, and a subsystem function should be 
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specified for each subsystem. The SIF is completed by the project leader. A form is submitted 
at the time of the preliminary design review (PDR) and any time thereafter when a new 
subsystem is introduced into the design of the system. 

SIF Fields 

D 1 Project name (PI) 

D2 Form date (P50) 

D50 Subsystem prefix (P47) 

D51 Subsystem name (P48) 

D52 Subsystem function (P49) 

The COF (Figure C-2) records information about a component in the system. Some of the 
information collected are the origin of the component, difficulty of developing the compo- 
nent, type of component, and purpose of component. The COF is completed by personnel 
who code new system components, modify old components for reuse, or transfer reused 
components to the project’s controlled library. A form is completed for each component in 
the system at the time when the component is moved into the project controlled source 
library. 

COF Fields 

D21 Programmer Name (P24) 

D1 Project Name (PI) 

D2 Form Date (P52) 

D50 Subsystems Prefix (P47) 

D53 Component name (P51) 

D54 Date entered into controlled library (P53) 

D55 Relative difficulty of developing component (P57) 

D56 Origin (P56) 

D57 Type of component (P58) 

D58 Purpose of executable component (P59) 

D59 COF form number; unique identifier distinguishing this form from other COFs 

The CRF (Figure C-l) contains information about the type of change that was made, the 
components that were changed, error information if applicable, and Ada-specific informa- 
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tion if applicable. The CRF is completed by personnel who implement changes to the system 
that involve modifying components in the project’s controlled source library. A form is 
submitted for each change to the system at the time the changed components are updated in 
the project’s controlled source library. 

CRF Fields 

D21 Programmer name (P24) 

D1 Project name (PI) 

D2 Form date (P65) 

D50 Subsystem prefixes of components changes (P84) 

D53 Names of components changed (P84) 

D63 Date on which need for change was determined (P72) 

D64 Date change was completed (P73) 

D65 Effort to isolate change (P66) 

D66 Effort to implement change (P67) 

D67 Type of change (P76) 

D68 Change to one component (P68) 

D69 Look at any other components (P70) 

D70 Aware of parameters (P71) 

D71 Source of error (P77) 

D72 Class of error (P78) 

D73 Omission error (P80) 

D74 Commission error (P79) 

D75 Transcription error (P8 1 ) 

D76 Did Ada contribute to the change (P69) 

D77 Ada features involved (P85) 

D78 Documentation understandable (P82) 

D79 Which statement best describes the cause of the Ada error (P83) 
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D80 Which resources provided the information needed to correct the error (P86) 
D8 1 Which tools provided aided in correction of the error (P87) 

D82 CRF form number (P63) 

The MCRF (Figure C-4) contains information about the type of change that was made to the 
components in a project’s maintenance controlled library. This form is submitted whenever 
the maintenance programmer has completed the work associated with a particular OSMR. 

MCRF Fields 

D21 Programmer name (P24) 

D162 OSMR number (P178) 

D1 Project name (PI) 

D2 Form date (P65) 

D163 Type of change (PI 79) 

D164 Cause of change (PI 80) 

D165 Effort to isolate change (P181) 

D166 Effort to implement change (PI 82) 

D167 Changed objects (PI 83) 

D168 Change characteristic (PI 84) 

D 1 69 Number of lines of code added (P 1 85) 

D170 Number of lines of code changed (PI 86) 

D 1 7 1 Number of lines of code deleted (P 1 87) 

D 1 72 N um ber of components added (P 1 8 8 ) 

D173 Number of components changed (PI 89) 

D 1 74 N um ber of components deleted (P 1 90 ) 

D175 Number of added components that are totally new (P191) 

D 176 Number of added components that are totally reused (P192) 

D177 Number of added components that are reused with modifications (P193) 

D178 MCRF form number; unique identifier distinguishing this form from other 

MCRFs 
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3.1.4 Project Development Completion Forms 

The Project Completion Statistics Form (PCSF) and the Subjective Evaluation Form (SEF) 
provide project completion information for projects that have completed development and 
have been delivered to maintenance and operations. The PCSF (Figure C-7) is used to record 
the final development statistics for the project. This information includes the actual project 
resource expenditures, project schedule, and the software product size. 

The PCSF is completed by SEL personnel and is verified by the project leader. It is com- 
pleted during “closeout”, a process of project data validation and verification. The PCSF 
data fields are described below. Note that, as in the PEF, the phase date fields contain the start 
dates of each of the listed life-cycle phases that apply to the project. The end date for a given 
phase is the next phase start date entered on the form, or the project end date if there are no 
start dates for subsequent phases. 

PCSF Fields 

D1 Project name (PI) 

D2 Form date (PI 24) 

D84 Requirements; actual requirements definition phase start date (PI 25) 

D85 Design; actual design phase start date (PI 26) 

D86 Implementation; actual implementation (code and test) phase start date (PI 27) 
D87 System test; actual system test phase start date (PI 28) 

D88 Acceptance test; actual acceptance test phase start date (PI 29) 

D89 Cleanup; actual cleanup phase start date (PI 30) 

D90 Maintenance; actual maintenance stage start date (P131) 

D91 Project end; actual project end date 
D92 Technical and management hours (PI 32) 

D93 Services hours (P133) 

D38 Computer name (PI 34) 

D94 CPU hours (PI 35) 

D95 Number of runs (PI 36) 

D96 Number of subsystems (PI 37) 

D97 Num ber of components ( P 1 3 8 ) 
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D98 Number of changes (PI 39) 

D99 Pages of documentation (PI 40) 

D100 Total SLOC(P141) 

D101 Total SLOC for all new components (P142) 

D102 Total SLOC for all slightly modified components (P143) 

D21 1 Total SLOC for all extensively modified components (P213) 

D103 Total SLOC for all old components (reused from other systems without modifi- 
cation) (PI 44) 

D104 Comments (P145) 

D105 Total executable components (PI 46) 

D106 Total new executable components (P147) 

D107 Total slightly modified executable components (P148) 

D212 Total extensively modified executable components (P214) 

D 1 08 Total old executable components (reused from other systems without modifica- 
tion) (PI 49) 

D109 Total executable statements for all FORTRAN components (PI 50) 

D110 Total executable statements for all new FORTRAN components (P 1 5 1 ) 

Dill Total executable statements for all slightly modified FORTRAN components 
(P152) 

D213 Total executable statements for all extensively modified FORTRAN compo- 
nents (P215) 

D112 Total executable statements for all old FORTRAN components (reused from 
other systems without modification) (PI 53) 

D214 Total statements (P216) 

D215 Total statements for all new components (P217) 

D216 Total statements for all slightly modified components (P218) 

D217 Total statements for all extensively modified components (P219) 

D218 Total statements for all old components (reused from other systems without 
modification) (P220) 

D113 PCSF form number; unique identifier distinguishing this form from other 
PCSFs 
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The SEF (Figure C-12) consists of subjective perceptions of persons who were involved in 
managing the project with respect to such factors as the use of methodologies, the develop- 
ment environment, and the complexity of the problem. The SEF is completed by the project 
leader and selected personnel involved in managing the project. The responses from each of 
the completed forms are combined and reported on one form. The SEF is submitted when the 
final system products have been delivered (end of cleanup phase). 

SEF Fields 

D1 Project name (PI) 

D2 Form date (PI 3) 

D1 14 Problem difficulty or complexity (P88) 

D115 Tightness of schedule constraints (P89) 

D1 16 Stability of requirements (P90) 

D117 Quality of specification documents (P91) 

D1 18 Requirements for documentation (P92) 

D1 19 Rigor of formal reviews (P93) 

D120 Ability of development team (P94) 

D121 Development team experience with application (1*95) 

D122 Development team experience with environment (P96) 

D123 Stability of development team composition (P97) 

D124 Project management performance (P98) 

D125 Project management experience (P99) 

D126 Stability of project management team (PI 00) 

D127 Project planning discipline (PI 01) 

D128 Degree project plans followed (PI 02) 

D129 Modem programming practices (P103) 

D130 Disciplined specification modification and question tracking (P 104) 

D131 Use of requirements analysis methodology (P105) 

D132 Use of disciplined design methodology (PI 06) 
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D133 Use of disciplined testing methodology (P107) 

D134 Use of tools (PI 08) 

D135 Use of test plans (P109) 

D136 Use of quality assurance procedures (PI 10) 

D 1 37 Use of configuration management procedures (Pill) 

D138 Degree of access to development system (PI 12) 

D139 Programmers per terminal (P113) 

D140 Development machine resource constraints (PI 14) 

D 1 4 1 System response time (PI 15) 

D142 System hardware and support software stability (PI 16) 

D143 Software tool effectiveness (P117) 

D144 Delivered software supports requirements (P118) 

D145 Quality of delivered software (PI 19) 

D146 Quality of design present in delivered software (PI 20) 

D147 Quality and completeness of software documentation (PI 21) 

D148 Timely software delivery (PI 22) 

D149 Smoothness of acceptance testing (P123) 

D150 SEF form number; unique identifier distinguishing this form from other SEFs 

3.1.5 Project Data Forms 

The Project Startup Form (PSF) and Project Messages Form (PMF) are used to record 
miscellaneous descriptive information about a project. Both forms are completed by SEL 
personnel with information provided by the project leader. 

The PSF (Figure C-10) is completed only once at project startup. The PSF information is 
obtained at the project startup meeting between SEL personnel and the project leader. The 
PSF data are stored as project messages. 

PSF Fields 

D1 Project name (PI) 

D2 Form date 
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D60 Project type (P2) 

D61 Project message type; NOTE_TYPEs of COMPACCTS, COMPSYS, 
CONTACTS, FORMSCOL, GENMESS, LANGUAGES, PROJNAME, and 
TASKNO (P4) 

D62 Project message (P4) 

The PMF (Figure C-9) captures general notes about a project, unique characteristics of the 
methodologies used, or peculiarities about the project’s data. A PMF can be completed any 
time SEL personnel or the project leader feel that something about the project should be 
documented. A general message is always entered during project closeout. 

PMF Fields 

D 1 Project name (P 1 ) 

D2 Form date 

D61 Project message type; NOTE_TYPE of GENMESS (P4) 

D62 Project message (P4) 

3.1.6 Project Development Status Forms 

The DSF provides project development status information for active projects. The DSF, 
(Figure C-3) is used to record such project status information as the number of components 
designed and coded and the number of tests performed. The DSF is completed on a bi-weekly 
basis by the project leaders of all active projects. 

DSF Fields 

D21 Name of originator (P24) 

D 1 Project name (PI) 

D22 Week ending date; this date is always a Friday (P23) 

D180 Total number of components to be designed (P195) 

D181 Number of components designed as of the week ending date (PI 96) 

D182 Total number of components to be coded (PI 97) 

D1 83 Number of components coded as of the week ending date (P 198) 

D184 Total number of separate system tests planned (P199) 

D185 Number of system tests executed at least one time (P200) 
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D186 Number of system tests passed (P201) 

D188 Total number of separate acceptance tests planned (P203) 

D189 Number of acceptance tests executed at least one time (P204) 

D190 Number of acceptance tests passed (P205) 

D192 Total number of discrepancies reported (P207) 

D193 Total number of discrepancies resolved (P208) 

D194 Total number of specification modifications received (P209) 

D195 Total number of specification modifications completed (P210) 

D196 Total number of requirements questions submitted to analysts (P21 1) 

D197 Total number of requirements questions answered by analysts (P212) 

D198 DSF form number; unique identifier distinguishing this form from other DSFs 
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SECTION 4— A LOGICAL VIEW OF THE SEL DATABASE 


This section presents the logical schema of the SEL database. The introduction to relational 
databases in Section 1, together with the table descriptions in the following sections, allow 
the reader to understand where the data items described in Sections 2 and 3 may be found in 
the database. This section also presents some additional information about the way the data 
are stored and describes the tables containing database support data. These latter discussions 
are intended for the reader who needs to understand the database at a deeper level, such as a 
database maintenance programmer. 

Section 4.1 defines each table in the SEL database. Section 4.2 describes how the tables are 
related to one another and constraints that are imposed on the tables by the semantics of the 
SEL data. Section 4.3 maps the data items as defined conceptually in Sections 2 and 3 to each 
item’s location in a database table. This section also describes the access path to follow to 
reach each end data item. 

In addition to the tables in the SEL database on the VAX, there are tables on the personal 
computer (PC) that are used for storing and maintaining DSF data. Since the DSF data are 
entered and quality assured by using the Database Access Manager for the SEL-PC 
(DAMSEL-PC) system , tables for storing DSF data are replicated on the PC. Some addition- 
al tables also exist on the PC to store validation data downloaded from the VAX database. 
This information is presented in Table 4-2 in a separate PC section. Tables for the VAX DSF 
Hata are described, along with others, both in Tables 4-1 and 4-2. 

4.1 DATABASE TABLE AND VIEW DEFINITIONS 

The SEL database contains a total of 78 base tables (relations) and 51 views. Base tables are 
defined independently of other tables in the sense that no base table is completely derivable 
from any other base table. On the other hand, views are virtual tables that are completely 
derived from base tables and contain no data of their own. With some restrictions, they can be 
treated as base tables. In the SEL database environment, views are used to provide users or 
application programmers with a more convenient way to access data items that spread across 
more than one base table. Tables 4- 1 and 4-2 both present tables and views in the database and 
their component fields. Table 4-1 contains only 40 tables and 5 views (on the VAX), and is 
intended for all database users. 

Table 4-2 contains additional tables and views that are mainly used for data entry, system 
maintenance, and project closeout, and are not relevant to general users. Table 4-1 presents 
the following information for each table and view included: 

• Table or view name and a brief description of the data it contains 

• For each column included in the table or view: 
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— Column name; an underlined column name is the primary keyfor accessing 
any table row. If multiple column names are underlined, the primary key is a 
concatenation of those columns. 

- Column description 

- Column type; see data type description following 

- A list of valid values for the column, as applicable; Appendix A contains a 
translation of these codes 

- One or more reference IDs that provide cross-references to data item de- 
scriptions in Sections 2 and 3, as applicable. Columns without reference IDs 
are generally internal identifiers that link rows in different tables and estab- 
lish the relational database. 

The data types for columns are CHAR, NUMBER, and DATE. A CHAR column can contain 
a sequence of alphanumeric characters. The number in parentheses is the maximum length of 
the field. A NUMBER column can contain only the numerals 0 through 9 and the signs + 
and — . The first number in the parentheses identifies the width of the numeric field. The 
second number (after the comma) identifies the number of places after the decimal point. A 
zero indicates that column entries must be integers. A DATE column can contain only a date, 
formatted as DD-MMM-YY. Reference 4 presents a more detailed description of ORACLE 
datatypes. 

Table 4-2 is intended for users, such as maintenance programmers, who need to know more 
of the technical specifications for all 64 base tables and 47 views on the VAX, and 14 base 
tables and 4 views on the PC. Provided for each field are name; data type; length (the number 
of decimal places is specified if the field is numeric); an indication of whether it is the 
primary key or part of the primary key; a specification of whether it can contain null values; 
and whether it is indexed. Fields that are identified as being indexed are those to be used 
frequently in join operations, in comparison, or in specifying search conditions. Unique 
indices exist for all fields or concatenations of fields that must have unique values within a 
particular table row. The last column in the table is for the view entries. It specifies the 
underlying table from which a particular column within a view is derived. 
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Table 4-1. SEL Database Tables and Views (1 of 21 ) 


Table or 
View Name 

Column Name 

Description 

Typ* 

Valid Code/ Value 

Reference iD 

CHANGE 


TABLE CONTAINING CRF 
INFORMATION FOR ALL 
CHANGES 




CHANG E_NO 

FORM NUMBER OF CRF 

CHAR (6) 


P63, D82 

PROGJD 

ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 

NUMBER 

(5, 0) 


1 

SUB_DATE 

SUBMISSION DATE OF 
CRF 

DATE 


P65, D2 j 

EFF_ONE 

YES/NO FLAG TO INDI- 
CATE WHETHER 
CHANGE WAS MADE TO 
ONE AND ONLY ONE 
COMPONENT 

CHAR (1) 

Y, N 

P68, D68 

EFF_ADA 

YES/NO FLAG TO INDI- 
CATE WHETHER USE OF 
ADA CONTRIBUTED TO 
THIS CHANGE 

CHAR (1) 

Y, N 

P69, D76 

EFFJSCLCH 

PROGRAMMER’S EF- 
FORT TO ISOLATE 
CHANGE 

CHAR (10) 

1HR, 1 DAY, 3DAY, 
NDAY, NOTDET 

P66, D65 

EFF_COM_CH 

PROGRAMMER'S EF- 
FORT TO IMPLEMENT 
CHANGE 

CHAR (10) 

1HR, 1DAY, 3DAY, 
NDAY, NOTDET 

P67 t D66 

EFF_PARPA 

YES/NO FLAG TO INDI- 
CATE WHETHER PRO- 
GRAMMER HAD TO BE 
AWARE OF PARAME- 
TERS PASSED 

CHAR (1) 

Y, N 

P71 , D70 

EFF_OTHER 

YES/NO FLAG TO INDI- 
CATE WHETHER PRO- 
GRAMMER LOOKED AT 
ANY OTHER COM- 
PONENTS 

CHAR (1) 

Y, N 

P70, D69 

DATE_DETER 

DATE ON WHICH NEED 
FOR CHANGE WAS DE- 
TERMINED 

DATE 


P72, D63 

DATE_COMP 

DATE ON WHICH 
CHANGE WAS COM- 
PLETED 

DATE 


P73, D64 

NUM_COM_CH 

TOTAL NUMBER OF 

COMPONENTS 

CHANGED 

NUMBER 

(3, 01 


P74 

NUM_COM_EX 

TOTAL NUMBER OF 
COMPONENTS EX- 
AMINED 

NUMBER 

(2,0) 


P75 
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Table 4-1. SEL Database Tables and Views (2 of 21) 


Table or 
View Name 

Column Name 

Description 

Typ» 

Valid Code/ Value 

Reference iD 

CHANGE 

(CONTD) 

CH_TYPE 

TYPE OF CHANGE 

CHAR (10) 

ERRCO, PLANE, 
IMPRE, IMPCM, 
IMPUS, IN/DE, OPTSA, 
ADENC, OTHCH 

P76, D67 

FORM_TYPE 

TYPE OF DATA COLLEC- 
TION FORM 

CHAR (6) 

CRF 


STATUS 

STATUS OF CRF 

CHAR (10) 

UNCHK, HCCORRECT, 
HCERROR, VERAP. 
CLOSED 


CHANGE 

COM 


TABLE CONTAINING 
CHANGED COM- 
PONENTS ASSOCIATED 
WITH PARTICULAR CRFs 



1 

iEIEZSSEOBI 

FORM NUMBER OF CRF 
FROM TABLE CHANGE 

CHAR (6) 


P63, D82 

■S39 


ID OF CHANGED COM- 
PONENT FROM TABLE 
SUB_COM 

NUMBER 

(7. 0) 



■■ 

CH 

ADAFEAT 

l 

TABLE CONTAINING ADA 
FEATURES THAT WERE 
INVOLVED IN OR CON- 
TRIBUTED TO PARTICU- 
LAR CHANGES 




CHANGE_NO 

FORM NUMBER OF CRF 
FROM TABLE CHANGE 

CHAR (6) 


P63, D82 


ADA_FEATURE 

FEATURES(S) INVOLVED 
IN CHANGE IF ADA IS 
USED AS DESIGN AND 
IMPLEMENTATION LAN- 
GUAGE 

CHAR (10) 

DATATYPE, 
SUBPROG, EXCEPT. 
GEN, PACK, TASK, 
SYSDEPF, OTHER 

P85, D77 

CH ERR 
ARES 


TABLE CONTAINING 
RESOURCES USED IN 
CORRECTING ERRORS 
FOR PARTICULAR 
CHANGES INVOLVING 
ADA 





FORM NUMBER OF CRF 
FROM TABLE CHANGE 

CHAR (6) 


P63. D82 


ERR_ARES 

RESOURCES USED TO 
CORRECT ERROR 
CAUSED BY USE OF ADA 

CHAR (10) 

NOTE, REFMAN, 
TEAM, MEMORY, 
NTEAM, OTHER 

P86, D80 

CH ERR 
GEN 


TABLE CONTAINING 
ERROR CHARACTER- 
ISTICS FOR PARTICULAR 
CHANGES IDENTIFIED 
AS ERROR CORREC- 
TIONS 




CHANGE_NO 

FORM NUMBER OF CRF 
FROM TABLE CHANGE 

CHAR (6) 


P63, D82 | 

i 

l 
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Table 4-1. SEL Database Tables and Views (3 of 21) 


Table or 
View Name 

Column Name 

Description 

Typ* 

Valid Code/ Value 

Reference ID 

CH ERR 
GEN 

(CONTD) 

ERR_SOURCE 

SOURCE OF ERROR 

CHAR (10) 

REQMT, FUNSPEC, 
DESIGN, CODE, 
PRECH, NOTDET 

P77. D71 


ERR_CLASS 

CLASS OF ERROR 

CHAR (10) 

IN IT, LOGIC, INTER!, 
INTERE, DATAVAL, 
COMPUTE, NOTDET 

P78, D72 


ERR_COMIS 

YES/NO FLAG TO INDI- 
CATE WHETHER ERROR 
WAS ONE OF COMMIS- 
SION 

CHAR (1) 

Y, N 

P79, D74 


ERR_TYPO 

YES/NO FLAG TO INDI- 
CATE WHETHER ERROR 
WAS TYPOGRAPHICAL 

CHAR (1 ) 

Y, N 

P81.D75 


ERRJDMIS 

YES/NO FLAG TO INDI- 
CATE WHETHER ERROR 
WAS ONE OF OMISSION 

CHAR (1) 

Y, N 

P80, D73 


ERR_ADOC 

YES/NO FLAG TO INDI- 
CATE WHETHER ADA 
COMPILER DOCUMEN- 
TATION OR ADA LAN- 
GUAGE REFERENCE 
MANUAL EXPLAINS IN- 
VOLVED FEATURES 
CLEARLY 

CHAR (1) 

Y, N 

P82, D78 


ERR_ACAUSE 

CAUSE OF ERROR IN- 
VOLVING ADA 

CHAR (10) 

INTERACT, INCOF, 

FEATUREM, 

FEATUREC 

P83, D79 

CH ERR 
TOOLS 


TABLE CONTAINING 
TOOLS USED IN COR- 
RECTING ERRORS FOR 
PARTICULAR CHANGES 
INVOLVING ADA 






FORM NUMBER OF CRF 
FROM TABLE CHANGE 

CHAR (6) 


P63, D82 


ERR_TOOLS 

ADA TOOLS USED THAT 
AIDED IN DETECTION OR 
CORRECTION OF ER- 

CHAR (10) 

COMP!, SYMDEB, LSE, 
CMS, SCA, PCA 
DECTM, OTHER 

P87, D81 


COMPUTER 


CPU NAME 


C FULL NAME 


ROR 

TABLE CONTAINING 
INFORMATION ABOUT 
COMPUTERS USED ON 
VARIOUS PROJECTS 


SHORT UNIQUE NAME 
IDENTIFYING A PARTICU- 
LAR COMPUTER 


COMPUTER FULL NAME 


CHAR (10) 


P 44, PI 34, 
M4, D38 


CHAR (20) 


M5 
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Table 4-1 . SEL Database Tables and Views (4 of 21 ) 


TabU or 
Vlaw Nam* 

Column Nam* 

Dascrtpfion 

Typ* 

Valid Coda/ Valua 

Rafaranca ID 

COM 

PURPOSE 


TABLE CONTAINING 
PURPOSES REPORTED 
ON COFs FOR EXECUT- 
ABLE COMPONENTS 





_ 

ID UNIQUELY IDENTIFY- 
ING EACH COMPONENT 
(FROM TABLE SUB_COM) 

NUMBER 

(7. 0) 




PURPOSE 

MAJOR PURPOSE(S) OF 
COMPONENT 

CHAR (10) 

IOPRO, ALCOMP, 
DATRA, LODEC, 
CNTRMOD, INTOP, 
ADAPR, ADAOA 

P59, D58 

COM 

SOURCE 


TABLE CONTAINING COF 
INFORMATION FOR ALL 
COMPONENTS 






ID UNIQUELY IDENTIFY- 
ING EACH COMPONENT 
(FROM TABLE SUB_COM) 

NUMBER 

(7.0) 




PROGJD 

ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 

NUMBER 

(5. 0) 




FORMJMO 

FORM NUMBER OF COF 

CHAR (6) 


D59 


FORM_TYPE 

TYPE OF DATA COLLEC- 
TION FORM 

CHAR (6) 

COF 



STATUS 

STATUS OF COF 

CHAR (10) 

UNCHK, HCCORRECT, 
HCERROR, VERAP, 
CLOSED 



CREATEJDATE 

DATE ON WHICH COM- 
PONENT WAS ENTERED 
INTO CONTROLLED LI- 
BRARY 

DATE 


1 P53, D54 


ORI_TYPE 

ORIGIN OF COMPONENT 

CHAR (10) 

NEW, EXT MO, SLMOD, 
OLDUC 

P56, D56 


COM_TYPE 

TYPE OF COMPONENT 

CHAR (10) 

INCL, JCL, ALC, 
FORTRAN, PASCAL, 
NAMELT, DISPLAY, 
MENDEF, REFDATA, 
BLOCKDA, ADASUBS, 
ADASUBB, 
ADAPACKS, 
ADAPACKB, 
ADATASKS, 
ADATASKB, 
ADAGENS, ADAGENB, 
ADAUNSPEC, OTHER 

P58, D57 


DIFFICULTY 

DEGREE OF DIFFICULTY 
IN CREATING PARTICU- 
LAR COMPONENT 

NUMBER 

(2, 0) 

1 TO 5 

P57, D55 


SUBJWE 

SUBMISSION DATE OF 
COF 

DATE 


P54, D2 
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Table 4-1. SEL Database Tables and Views (5 of 21) 


Table or 
View Name 

Column Name 

Description 

Type 

Valid Code/ Value 

Reference ID 

COM.STAT 

% 


TABLE CONTAINING 
STATISTICS FOR ALL 
COMPONENTS 





ID UNIQUELY IDENTIFY- 
ING EACH COMPONENT 
(FROM TABLE SUB_COM) 

NUMBER 

(7, 0) 



mm 

C_EXE_S 

NUMBER OF EXECUT- 
ABLE STATEMENTS IN 
COMPONENT 

NUMBER 

(6, 0) 


PI 54 

CJJNE 

NUMBER OF SOURCE 
LINES OF CODE (WITH 
COMMENTS) IN COM- 
PONENT 

NUMBER 

(6, 0) 


PI 55 

C.C.LINE 

NUMBER OF COMMENT 
LINES IN COMPONENT 
(NO BLANK LINES) 

NUMBER 

(6, 0) 


PI 56 

C_STMT 

NUMBER OF STATE- 
MENTS IN THE COM- 
PONENT 

NUMBER 

(6, 0) 


P221 

FINAL ORIGIN 
CAT 

ORIGIN CATEGORY AS- 
SIGNED TO THE COM- 
PONENT FOR COMPUT- 
ING FINAL STATISTICS 

CHAR (10) 

NEW, EXTMO, SLMOD, 
OLDUC 

P222 

DSF 

MEASURE 


TABLE CONTAINING DSF 
MEASUREMENT DATA 




DJD 

D ID FROM TABLE 
PROJ.DSF 

NUMBER 

(10,0) 



STATUS.CODE 

TYPE OF DSF DATA 

CHAR (10) 

DESIGN, CODE, 
SYSTEST, ACCTEST, 
DISCREP, 
QUESTIONS, 
SPECMOD 


MEASURE. 

TYPE OF DSF MEASURE 

CHAR (10) 

MODDESIGN, 

MODCODE, 

SYSTSTONE, 

SYSTSTPASS, 

SYSTSTRUN, 

ACCTSTONE, 

ACCTSTPASS, 

ACCTSTRUN, 

DISCRES, QUESTANS, 

SPECMODIMP 

PI 96, Pi 98, 
P200, P204. 
P208. P21 0. 
P212 


MEASURE 

VALUE 

VALUE OF DSF MEA- 
SURE 

NUMBER 

(5, 0) 


PI 96, 0181, 
PI 98, D1 83. 
P200— P202. 
D185-D186, 
P204-P206, 
D189-D190 
P2Q8, D1 93. 
P210, D195. 
P212, Dl 97 
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Table 4-1. SEL Database Tables and Views (6 of 21 ) 


Table or 
View Name 

Column Name 

Description 

DSF 


TABLE CONTAINING OSF 

TARGET 


TARGET DATA 


DJD 

D ID VALUE FROM 
TABLE PROJ_DSF 



TYPE OF DSF DATA 



TYPE OF DSF TARGET 


TARGET J/ALUE 

| 

VALUE OF DSF TARGET 

EFF_ACT 


TABLE CONTAINING 
TECHNICAL AND DIRECT 
MANAGEMENT ACTIVITY 
HOURS FROM CLPRFs 
OR PRFs AND SERVICE 
PERSONNEL HOURS 
FROM SPFs FOR ALL 
PROJECT, PERSONNEL, 
AND WEEK COMBINA- 
TIONS 


EFFJD 

P ID VALUE FROM 
TABLE EFF PROJ OR 
PS ID VALUE FROM 
TABLE EFF SUB 


Valid Coda/ Value 


Reference ID 



CHAR (10) 


DESIGN, CODE. 
SYSTEST, ACCTEST. 
DISCREP, 
QUESTIONS. 
SPECMOD 


TOTDESIGN, 

TOTCODE, 

TOTSYSTST, 

TOTACCTST. 

TOTDISCREP, 

QUESTSUB, 

SPECMODREC 


NUMBER 

(5, 0) 


NUMBER 

( 10 , 0 ) 



PI 95. Pi 97, 
Pi 99, P203, 
P207, P209, 
P211 



ACTIVITY 

ACTIVITY TO WHICH 

CHAR (10) 

ACCTEST, 

P25-P34, 


PERSONNEL ARE 

CLACCTEST, 

P39-P40, 


CHARGING TIME ON 


CLCREDES, 

P42-P43, 


CLPRF, PRF, OR SPF 


CLINDTEST, 

CLOTHER, 

CLPREDES, 

CLP RETEST, 
CLRDREVCOD, 
CLRESPSFR, 
CLVEREVDES, 
CLWRCODE, CREDES. 
DEBUG, INTTEST. 
OTHER, PREDES. 
RDREVCOD. 
RDREVDES, 

SUPPORT, 

TSTCODUN, WRCODE 

PI 57-PI 66 

! 
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Table 4-1. SEL Database Tables and Views (7 of 21 ) 


Table or 
View Name 

EFF_ACT 

(CONTD) 


EFF FORM 


EFF PROJ 



Column Name 



Description 


ACTUAL HOURS SPENT 
IN PARTICULAR ACTIV- 
ITY 


Valid Code/ Value 


NUMBER 

( 10 , 2 ) 


FORM NO 


FORM TYPE 



TABLE CONTAINING 
FORM IDENTIFICATION 
AND STATUS INFORMA- 
TION FOR EACH PROJ- 
ECT, PROGRAMMER AND 
WEEK COMBINATION; 
ENTERED FROM 
CLPRFs, PRFs, OR SPFs 


PJD VALUE FROM 
TABLE EFFJ>ROJ 


FORM NUMBER OF 
CLPRF, PRF, OR SPF 


TYPE OF DATA COLLEC- CHAR (6) 
TION FORM 


STATUS OF CLPRF, PRF, CHAR (10) 
OR SPF 


TABLE ASSOCIATING 
GIVEN PROJECT, PRO- 
GRAMMER, AND WEEK 
COMBINATION WITH 
SURROGATE KEY (PJD) 
FOR USE IN OTHER 
TABLES 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 


SUBMISSION DATE OF 
CLPRF, PRF, OR SPF 


ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 


SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE PROJ_NO, 
PROGJD, AND 
SUBJDATE COMBINA- 
TION 
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Table 4-1. SEL Database Tables and Views (8 of 21) 


Tabl# or 
VWw Nam* 

Column Nam* 

D**cription 

Typ. 

Valid Cod*/ Valu* 



TABLE ASSOCIATING 
P ID AND SUBSYSTEM 
PREFIX WITH SURRO- 
GATE KEY (PSJD) FOR 
USE IN OTHER TABLES 


P ID VALUE FROM 
TABLE EFF_PROJ 


SUBSYSTEM PREFIX 
FROM TABLE PROJ_SUB 


SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE P ID AND 
SUB_PRE COMBINATION 


TABLE CONTAINING 
PROGRAMMER MAINTE- 
NANCE HOURS FROM 
WMEFs GROUPED BY 
ACTIVITIES 


MAINTJD VALUE FROM 
TABLE MAINTJ=>ROJ 


ACTIVITY TO WHICH 
PROGRAMMER IS 
CHARGING TIME ON 
WMEF 


ACTUAL HOURS SPENT 
IN PARTICULAR ACTIV- 
ITY 


TABLE CONTAINING 
INFORMATION FOR ALL 
MAINTENANCE 
CHANGES 


FORM NUMBER OF 
MCRF 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 



NUMBER 

(3. 0) 


PROGJD 

ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 

NUMBER 

(5,0) 


SUB_DATE 

SUBMISSION DATE OF 
MCRF 

DATE 


OSMR_NO 

OSMR NUMBER 

NUMBER 

(4. 0) 


STATUS 

! STATUS OF MCRF 

CHAR (10) 

UNCHK, HCCORRECT 
HCERROR, VERAP, 
CLOSED 


P65, D2 
PI 78, D162 
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Table 4-1. SEL Database Tables and Views (9 of 21) 


Table or 
View Mama 

Column Name 

Description 

Typ* 

Valid Coda/ Value 

Reference ID 

MAINT 

CHANGE 

(CONT'D) 

FORM_TYPE 

TYPE OF DATA COLLEC- 
TION FORM 

CHAR (6) 

MCRF 



MAINT CH 
TYPE 

TYPE OF MODIFICATION 

CHAR (10) 

CORRECTION, 

ENHANCEMNT, 

ADAPTATION 

PI 79, D163 


CH_CAUSE 

CAUSE OF CHANGE 

CHAR (10) 

REQMTSPEC, 
DESIGN, CODE, 
PRECH, OTHER 

PI 80, D164 


MAINT_ISO_CH 

PROGRAMMER'S EF- 
FORT TO ISOLATE 
CHANGE 

CHAR (10) 

1HR, 1DAY, 1WEEK, 
1 MONTH, 

1 MONTH MO RE 

PI 81 , D165 


MAINT COM 
CH 

PROGRAMMER'S EF- 
FORT TO IMPLEMENT 
CHANGE 

CHAR (10) 

1HR, 1DAY, 1WEEK, 
1 MONTH, 
1MONTHMORE 

PI 82, D166 


CH_CLASS 

CLASS OF CHANGE 

CHAR (10) 

INIT, LOGIC, INTERI, 
INTERE, DATAVAL, 
COMPUTE, OTHER 

PI 84, D168 


EST_LOC_ADD 

ESTIMATED NUMBER OF 
LINES OPCODE ADDED 

NUMBER 

<6, 0) 


PI 85, D169 


EST_LOC_CH 

ESTIMATED NUMBER OF 
LINES OF CODE 
CHANGED 

NUMBER 

(6. 0) 


PI 86, D170 


EST_LOC_DEL 

ESTIMATED NUMBER OF 
LINES OF CODE DE- 
LETED 

NUMBER 

(6. 0) 


PI 87, 0171 [ 


COMP_ADD 

NUMBER OF COM- 
PONENTS ADDED 

NUMBER 

(4. 0) 


PI 88, D172 


COMP_CH 

NUMBER OF COM- 
PONENTS CHANGED 

NUMBER 

(4.0) 


PI 89, D173 


COMP_DEL 

NUMBER OF COM- 
PONENTS DELETED 

NUMBER 

(4. 0) 


PI 90, D174 


COMP ADD 
NEW 

NUMBER OF THE ADDED 
COMPONENTS THAT 
ARE TOTALLY NEW 

NUMBER 

(4, 0) 


PI 91 , D1 75 ! 


COMP ADD 
REUSE 

NUMBER OF THE ADDED 
COMPONENTS THAT 
ARE TOTALLY REUSED 
(UNCHANGED) 

NUMBER 
(4. 0) 


PI 92, D176 


COMP ADD 
REMOD 

| 

NUMBER OF THE ADDED 
COMPONENTS THAT 
ARE REUSED WITH 
MODIFICATIONS 

NUMBER 

(4. 0) 


PI 93, 0177 


10004437L 


4-11 










































































Table 4-1. SEL Database Tables and Views (10 of 21) 


TabU or 
VUw Nama 

Column Nama 

i 

DaacHpHon 

Typ. 

Valid Coda/ Valua 

Refarenca ID 



TABLE CONTAINING 
CHANGED OBJECTS 
ASSOCIATED WITH PAR- 
TICULAR MCRFs 


FORM NUMBER OF 
MCRF FROM TABLE 
MAI NT_C HANG E 


CHANGED OBJECT 


TABLE CONTAINING 
PROGRAMMER MAINTE- 
NANCE HOURS FROM 
WMEFs GROUPED BY 
CLASS OF MAINTE- 
NANCE 


MAINTJD VALUE FROM 
TABLE MAINT_PROJ 


CLASS OF MAINTE- 
NANCE TO WHICH PRO- 
GRAMMER IS CHARGING 
TIME ON WMEF 


ACTUAL HOURS SPENT 
IN PARTICULAR CLASS 
OF MAINTENANCE 


TABLE CONTAINING 
WMEF DATA. A GIVEN 
PROJECT PROGRAM- 
MER, AND WEEK ARE 
ASSOCIATED WITH SUR- 
ROGATE KEY (MAINTJD) 
FOR USE IN OTHER 
TABLES 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 


SUBMISSION DATE OF 
WMEF 


ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 



CHAR (6) 


CHAR (10) 


REQMTDOC, 
DESIGNDOC, CODE. 
SYSDESC, 
USERGUIDE, OTHER 


Pi 83, D167 



NUMBER 

( 10 , 0 ) 


CHAR (10) 


NUMBER 

( 10 . 2 ) 


CORRECTION, 
ENHANCEMNT, 
ADAPTATION, OTHER 



PI 68-PI 71 


Pi 68— Pi 71 , 
D151-D154 


NUMBER 
(5, 0) 


P23, D22 


P24, D21 


MAINTJD SURROGATE KEY AS- NUMBER 

SIGNED TO REPRESENT (10, 0) 
UNIQUE PROJ NO, 

SUB_DATE, AND 
PROGJD COMBINATION 

FORM J^O FORM NUMBER OF CHAR (6) 

WMEF 

FORM_TYPE TYPE OF DATA COLLEC- CHAR (6) 

TION FORM 



10004437L 


4-12 



















































Table 4-1 . SEL Database Tables and Views (11 of 21 ) 


Table or 
View Name 


MAINT_ 

PROJ 

(CONTD) 


PERSONNEL 


Column Name 






FULL NAME 


DATE ENTRY 



PROJ NO 


PROJ TYPE 


Description 


STATUS OF WMEF 


TABLE CONTAINING 
INFORMATION ABOUT 
PERSONNEL FOR WHOM 
DATA ARE RECORDED IN 
THE DATABASE 


ID ASSIGNED FOR 
UNIQUELY IDENTIFYING 
EACH PERSON SUBMIT- 
TING FORMS 


ABBREVIATED NAME AS 
IT APPEARS ON VARI- 
OUS FORMS 


CHAR (10) 


Valid Code/ Value 


UNCHK, HCCORRECT, 
HCERROR. VERAP, 
CLOSED 


Reference ID 



NUMBER 

(5, 0) 


CHAR (15) 



THIS FIELD ALSO 
INCLUDES THE 
FOLLOWING 
SERVICES 

PERSONNEL NAMES: 

LIBARIAN-L1BRARI- 

ANS 

OTHSUPP^OTHER 
SUPPORT PERSON- 
NEL 

PROGMGMT-PRO- 
GRAM MANAGEMENT 
PERSONNEL 

SECRTARY- 

SECRETARIES 

TECHPUBS-TECHNI- 
CAL PUBLICATIONS 
PERSONNEL 



CHAR (30) 



FULL DESCRIPTIVE 
NAME OF PERSON 


DATE ON WHICH PER- 
SONNEL DATA WERE 
ENTERED INTO DATA- 
BASE 


TABLE CONTAINING 
INFORMATION ABOUT 
ALL PROJECTS IN THE 
DATABASE 


PROJECT NAME 


ID ASSIGNED FOR NUMBER 

UNIQUELY IDENTIFYING (3, 0) 
EACH PROJECT 



PROJECT CATEGORY 


! CHAR (10) 


AGSS, ATTITUDE, 
DATABASE. 
GRAPH/UI. MP&A, 
ORBIT OTHER 
REALTIME, 
SIMULATOR, TOOL 


P2, D163 


10004437L 


4-13 





































Table 4-1. SEL Database Tables and Views (12 of 21) 


TabW or 
Vfew Name 

Column Nama 

Description 

PROJECT 

ACTIVE 

CURRENT STATUS OF 

(CONTD) 

STATUS 

PROJECT 

PROJ CPU 


TABLE CONTAINING 

STAT 


AT-COMPLETION COM- 
PUTER RESOURCE STA- 
TISTICS FOR ALL PROJ- 
ECTS IN DATABASE 



ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 



SUBMISSION DATE OF 
PCSF 


■ 

SHORT NAME IDENTIFY- 
ING COMPUTER USED 
ON PROJECT (FROM 
TABLE COMPUTER) 


TOTAL_HRS 

TOTAL COMPUTER 
HOURS USED ON PAR- 
TICULAR COMPUTER 
FOR PROJECT 


T RUN 

TOTAL NUMBER OF 



RUNS ON PARTICULAR 
COMPUTER FOR PROJ- 
ECT 

PROJ_DSF 


TABLE CONTAINING 
FORM IDENTIFICATION 
AND STATUS INFORMA- 
TION FOR EACH PROJ- 
ECT, PROGRAMMER, 
AND WEEK COMBINA- 
TION; ENTERED FROM 
DSFs 



ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 



SUBMISSION DATE OF 
DSF 


PROOJD 

ID UNIQUELY IDENTIFY- 
ING EACH PROGRAM- 
MER (FROM TABLE PER- 
SONNEL) 


FORM_NO 

FORM NUMBER OF DSF 


STATUS 

STATUS OF DSF 


FORMJTYPE 

TYPE OF DATA COLLEC- 
TION FORM 



NUMBER 
(5. 0) 


CHAR (6) 


CHAR (10) 

UNCHK. HCCORRECT, 
HCERROR, VERAP, 
CLOSED 



CHAR (6) I DSF 



I0004437L 


4-14 










































Table 4-1. SEL Database Tables and Views (13 of 21) 


Table or 
View Name 


Column Name 



Description 


SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE PROJJMO, 
SUB_DATE COMBINA- 
TION 


TABLE CONTAINING 
ESTIMATED STATISTICS 
FOR ALL PROJECTS IN 
DATABASE 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 


SUBMISSION DATE OF 
PEF 


ESTIMATED TOTAL NUM- 
BER OF SUBSYSTEMS 


ESTIMATED TOTAL NUM- 
BER OF COMPONENTS 


ESTIMATED TOTAL SLOC 


ESTIMATED TOTAL SLOC 
FOR ALL NEW COM- 
PONENTS 


ESTIMATED TOTAL SLOC 
FOR ALL MODIFIED COM- 
PONENTS 


ESTIMATED TOTAL SLOC 
FOR ALL REUSED COM- 
PONENTS 


ESTIMATED TOTAL PRO- 
GRAMMER HOURS 


ESTIMATED TOTAL MAN- 
AGEMENT HOURS 


ESTIMATED TOTAL SER- 
VICES HOURS 


NUMBER 
(7. 0) 



NUMBER 
(7, 0) 


NUMBER 

(7. 0) 


NUMBER 

(10.2) 


NUMBER 

( 10 , 2 ) 


NUMBER 

( 10 , 2 ) 


PROJ EST 
PHASE 


TABLE CONTAINING 
ESTIMATED AND AT- 
COMPLETION PHASE 
DATES FOR ALL PROJ- 
ECTS IN DATABASE 




ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 

NUMBER 

(3.0) 



SUBMISSION DATE OF 
PCSFOR PEF 

DATE 


a 

PHASE CODE IDENTIFY- 
ING DIFFERENT PHASES 
IN LIFE OF PROJECT 

CHAR (10) 



P5, P13, 
PI 24, D2 

REQNT, DESGN, 
CODET, SYSTE, 
ACCTE, CLEAN, 
MAINT 

P6-P21 , 

Pi 25— Pi 31 


10004437L 


4-15 






























































Table 4-1. SEL Database Tables and Views (14 of 21) 


Table or 
View Name 

Column Name 

Description 

Typ. 

Valid Code/ Value 


START DATE 



START DATE OF A PAR- 
TICULAR PHASE 


END DATE OF A PARTIC- 
ULAR PHASE 


TABLE CONTAINING 
FORM IDENTIFICATION 
AND STATUS INFORMA- 
TION FOR PCSF, PEF, 
SEF, AND SPF DATA 


ID UNIQUELY IDENTIFY- NUMBER 
ING EACH PROJECT (3, 0) 
(FROM TABLE PROJECT) 


SUBMISSION DATE OF 
PCSF, PEF, SEF, OR SPF 



Reference ID 


PS-P11, 
D3— 08, 
P125-P131 , 
D84-D90 


P6-P11, 
D4-D8, DIO, 
PI 25-PI 31, 
D85-D91 



PI 3, PI 24, 
D2, P 23, D22 


CHAR (6) 


FORM NUMBER OF 
PCSF, PEF, SEF, OR SPF 


TYPE OF DATA COLLEC- CHAR (6) 
TION FORM 



STATUS OF PCSF, PEF, 
SEF, OR SPF 


TABLE CONTAINING 
GROWTH HISTORY IN- 
FORMATION FOR ALL 
PROJECTS IN DATABASE 


CHAR (10) 


PCSF, PEF, SEF, SPF 


UNCHK, HCCORRECT, 
HCERROR, VERAP, 
CLOSED 



ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 

NUMBER 

(3. 0) 

SUBMISSION DATE OF 
SPF 

DATE 

TOTAL NUMBER OF 
LINES OF CODE (WITH 
COMMENTS) IN PROJ- 
ECT CONTROLLED 
SOURCE LIBRARY 

NUMBER 

(7.0) 

TOTAL NUMBER OF 
MODULES IN PROJECT 
CONTROLLED LIBRARY 

NUMBER 

(4. 0) 

TOTAL NUMBER OF 
CHANGES RECORDED 
IN PROJECT CON- 
TROLLED LIBRARY 

NUMBER 

(6, 0) 

TABLE CONTAINING 
GENERAL PROJECT 
DESCRIPTION INFORMA- 
TION FOR ALL PROJ- 
ECTS IN DATABASE 




10004437L 


4-16 























































Table 4-1. SEL Database Tables and Views (15 of 21) 


Table or 
View Name 

Column Name 

Description 

Type 

Valid Code/ Value 

Reference ID 

PROJ 

MESSAGES 

(CONT’D) 

SJD 

S ID FROM TABLE 
PROJ_NOTES 

NUMBER 

(5, 0) 




g 

LINE SEQUENCE NUM- 
BER WITHIN A MESSAGE 

NUMBER 

(3, 0) 




MESSAGES 

GENERAL PROJECT 
DESCRIPTION INFORMA- 
TION 

CHAR (65) 


P4, D62 


SUB_DATE 

DATE ON WHICH MES- 
SAGE WAS SUBMITTED 

DATE 


D2 


PROJ_ 

NOTES 


TABLE ASSOCIATING 
GIVEN PROJECT AND 
MESSAGE TYPE WITH 
SURROGATE KEY (S ID) 
FOR USE IN THE 
PROJ MESSAGES TABLE 


ID UNIQUELY IDENTIFY- NUMBER 


ING EACH PROJECT (3, 0) 


(FROM TABLE PROJECT) 





PROJ PROD 



GENERAL PROJECT 
DESCRIPTION CODES 


SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE PROJ_NO AND 
NOTEJTYPE COMBINA- 
TION 


TABLE CONTAINING 
WEEKLY COMPUTER 
RESOURCE USE IN- 
FORMATION FOR ALL 
PROJECTS IN DATABASE 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 


SUBMISSION DATE OF 
SPF 


SHORT NAME IDENTIFY- 
ING COMPUTER USED 
ON A PROJECT (FROM 
TABLE COMPUTER) 


CHAR (10) CLOSEOUT, P4, D61 

COMPACCTS, 

COMPSYS, 

CONTACTS, 

CONTRLLIB, 

DATAAVAIL, 

FORMSCOL, 

GENMESS, GHTOOL, 
LANGUAGES, 

PROJNAME, TASKNO 



RESJHR TOTAL CPU HOURS NUMBER P45, D39 

USED IN CURRENT (10,2) 

WEEK 


1 0004437 L 


4-17 











































Table 4-1. SEL Database Tables and Views (16 of 21) 


Tab I* or 
View Nam* 


Column Nam* 



SUB DATE 


Description 


TOTAL RUNS MADE IN 
CURRENT WEEK 


TABLE CONTAINING 
SUBJECTIVE MEASURES 
FROM SEFs FOR ALL 
PROJECTS IN DATABASE 


ID UNIQUELY IDENTIFY- NUMBER 
ING EACH PROJECT (3, 0) 
(FROM PROJECT TABLE) 


Valid Coda/ Value 



CODES IDENTIFYING 
SUBJECTIVE PROJECT 
CHARACTERISTICS 


CHAR (10) 


NUMBER 

( 1 . 0 ) 


INTEGER INDICATING 
THE VALUE OF A PAR- 
TICULAR MEAS TYPE 


TABLE CONTAINING 
SECONDARY-LEVEL 
INFO, AS RECORDED ON 
SEFs, FOR ALL PROJ- 
ECTS IN DATABASE 


ID UNIQUELY IDENTIFY- NUMBER 
ING EACH PROJECT (3, 0) 
(FROM TABLE PROJECT) 


CODE IDENTIFYING 
PROJECT CHARACTER- 
ISTICS AND TOOLS 
USED 


SECONDARY LEVEL 
INFORMATION FOR A 
PARTICULAR 
MEAS_TYPE; AT PRES- 
ENT, ALL THE CODES 
STORED HERE ARE FOR 
-USE OF TOOLS" (PC21) 


TABLE CONTAINING 
AT-COMPLETION STA- 
TISTICS FOR ALL PROJ- 
ECTS IN DATABASE 


CHAR (10) 


CHAR (10) 


, PM02, PM03, 
I, PM05, PM06, 
, ST08, ST 09, 

, TM11, TM12, 

, TM14, TM15, 

, PC17, PCI 8, 

, PC20, PC22, 

, PC24, EN25, 

, EN27, EN28, 

, EN30, PT31 , 

, PT33, PT34, 

, PT36 


Reference ID 


P46, D40 



P88-P1 07, 
D114-D133, 
PI 09-PI 23, 
D135-D149 


COMPL, LINK, EDIT, 
GRADIS, REPLP, 
STRANT, PDLPR, ISPF, 
SAP, CAT, PANVAL, 
TESTCO, INTERF, LSE, 
SYMDEB, CMTOOL, 
SDE, OTHER 


PI 08, D134 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 

NUMBER 

(3.0) 

SUBMISSION DATE OF 
PCSF 

DATE 



10004437L 
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Table 4-1. SEL Database Tables and Views (17 of 21) 


Table or 

View Name Column Name 


PROJ_STAT TECH_MAN_HR 
(CONT’D) 

SER HR _ 


T SYS 


T COM 


T DOC 


T LINE 


T NEW LINE 


T MOD LINE 


T OLD LINE 


T COMMENT 


T EXE MOD 


T NEW MOD 


T MOD MOD 


T OLD MOD 


T EXE STAT 


Description 

Typ* 

TOTAL TECHNICAL AND 
MANAGEMENT HOURS 
USED ON PROJECT 

NUMBER 

(10,2) 

TOTAL SERVICE HOURS 
EXPENDED ON PROJ- 
ECT 

NUMBER 
(10, 2) 

TOTAL NUMBER OF SUB- 
SYSTEMS 

NUMBER 

(4, 0) 

TOTAL NUMBER OF 
COMPONENTS 

NUMBER 

(4, 0) 

TOTAL NUMBER OF 
CHANGES 

NUMBER 

(6, 0) 

TOTAL PAGES OF DOC- 
UMENTATION 

NUMBER 
(6, 0) 

TOTAL SLOC FOR ALL 
COMPONENTS (IN- 
CLUDES BLANK LINES) 

NUMBER 

(7, 0) 

TOTAL SLOC FOR ALL 
NEW COMPONENTS 

NUMBER 

(6, 0) 

TOTAL SLOC FOR ALL 
SLIGHTLY MODIFIED 
COMPONENTS 

NUMBER 

(6, 0) 

TOTAL SLOC FOR ALL 
REUSED (UNCHANGED) 
COMPONENTS 

NUMBER 

(6. 0) 

TOTAL NUMBER OF 
COMMENT LINES (BLANK 
LINES NOT INCLUDED) 

NUMBER 

(6, 0) 

TOTAL NUMBER OF 
EXECUTABLE COM- 
PONENTS 

NUMBER 

(4. 0) 

TOTAL NUMBER OF NEW i 
EXECUTABLE COM- 
PONENTS 

: 

NUMBER 

(4, 0) 

TOTAL NUMBER OF 
SLIGHTLY MODIFIED 
EXECUTABLE COM- 
PONENTS 

NUMBER 

(4, 0) 

TOTAL NUMBER OF RE- 
USED (UNCHANGED) 
EXECUTABLE COM- 
PONENTS 

NUMBER 

(4, 0) 

TOTAL NUMBER OF 
EXECUTABLE STATE- 
MENTS FOR ALL FOR- 
TRAN COMPONENTS 

NUMBER 

(6, 0) 


Valid Code/ Value Reference ID 


PI 32, D92 


PI 33, D93 


PI 37, D96 


PI 38, D97 





PI 39, D98 


PI 40, D99 


Pi 41 , D100 


PI 42, D101 


PI 43, D102 


PI 44, D103 


PUS. D104 


PI 46, D105 


PI 47, D106 


PI 48, D107 


PI 49, D108 


Pi 50, Dl 09 


10004437L 


4-19 
























































Table 4-1. SEL Database Tables and Views (18 of 21) 


Table or 
View Mama 

Column Nam* 

Description 

Typ» 

PROJ STAT 
(CONT’D) 

T_NEW_STAT 

TOTAL NUMBER OF 
EXECUTABLE STATE- 
MENTS FOR ALL NEW 
FORTRAN COM- 
PONENTS 

NUMBER 

(6, 0) 


T_MOD_STAT 

TOTAL NUMBER OF 
EXECUTABLE STATE- 
MENTS FOR ALL SLIGHT- 
LY MODIFIED FORTRAN 
COMPONENTS 

NUMBER 

(6, 0) 


T_OLD_STAT 

TOTAL NUMBER OF 
EXECUTABLE STATE- 
MENTS FOR ALL RE- 
USED (UNCHANGED) 
FORTRAN COM- 
PONENTS 

NUMBER 

(6, 0) 


T_STMTS 

TOTAL NUMBER OF 
STATEMENTS 

NUMBER 

(6. 0) 


T_NEW_STMTS 

TOTAL NUMBER OF 
STATEMENTS FOR ALL 
NEW COMPONENTS 

NUMBER 

(6. 0) 


T_MOD_STMTS 

TOTAL NUMBER OF 
STATEMENTS FOR ALL 
SLIGHTLY MODIFIED 
COMPONENTS 

NUMBER 

(6, 0) 


T_OLD_STMTS 

TOTAL NUMBER OF 
STATEMENTS FOR ALL 
REUSED (UNCHANGED) 
COMPONENTS 

NUMBER 

(6.0) 


T_EXTMO_LINE 

TOTAL SLOC FOR ALL 
EXTENSIVELY MODIFIED 
COMPONENTS 

NUMBER 

(6. 0) 


T_EXTMO_MOD 

TOTAL NUMBER OF EX- 
TENSIVELY MODIFIED 
EXECUTABLE COM- 
PONENTS 

NUMBER 

(4. 0) 


T_EXTMO_STAT 

TOTAL NUMBER OF 
EXECUTABLE STATE- 
MENTS FOR ALL EXTEN- 
SIVELY MODIFIED FOR- 
TRAN COMPONENTS 

NUMBER 
(6, 0) 


T EXTMO 
STMTS 

TOTAL NUMBER OF 
STATEMENTS FOR ALL 
EXTENSIVELY MODIFIED 
COMPONENTS 

NUMBER 

(6. 0) 

PROJ_SUB 


TABLE ASSOCIATING 
PROJECT AND SUBSYS- 
TEM WITH SURROGATE 
KEY (SUBSY ID) THAT 
UNIQUELY IDENTIFIES 
THE SUBSYSTEM FOR 
USE IN OTHER TABLES 




10004437L 


4-20 






















































Table 4-1. SEL Database Tables and Views (19 of 21) 


Table or 
View Name 


PROJ_SUB 

(CONT'D) 


Column Name 



SUB DATE 


SUBSY ID 



Description 


ID UNIQUELY IDENTIFY- 
ING EACH PROJECT 
(FROM TABLE PROJECT) 


SUBSYSTEM PREFIX 


DATE SUBSYSTEM WAS 
SUBMITTED 


SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE PROJ_NO AND 
SUB_PRE COMBINATION 


TABLE CONTAINING 
PROGRAMMER ACTIVITY 
HOURS FROM CLPRFs 
OR PRFs (PART C) FOR 
ALL PROJECT, PRO- 
GRAMMER, AND WEEK 
COMBINATIONS 


PJD VALUE FROM 
TABLE EFF_PROJ OR 
PS_ID VALUE FROM 
TABLE EFF_SUB 


SPECIAL ACTIVITY TO 
WHICH PROGRAMMER 
IS CHARGING TIME ON 
CLPRF OR PRF 


ACTUAL HOURS SPENT 
IN A PARTICULAR ACTIV- 
ITY 


TABLE CONTAINING 
INFORMATION FOR PAR- 
TICULAR SUBSYSTEMS, 
AS RECORDED ON SIFs 


Valid Code/ Value 


NUMBER 

(3.0) 


ID UNIQUELY IDENTIFY- 

NUMBER 


ING EACH SUBSYSTEM 
(FROM TABLE 
PROJ_SUB) 

(5, 0) 


SUBSYSTEM DE- 

CHAR (40) 

SCRIPTIVE NAME 



SPECIFIC FUNCTION 

CHAR (10) 


THE SUBSYSTEM PER- 
FORMS 


TABLE ASSOCIATING 
SUBSYSTEM AND COM- 
PONENT NAME WITH 
SURROGATE KEY THAT 
UNIQUELY IDENTIFIES 
THE COMPONENT FOR 
USE IN OTHER TABLES 



USERINT, DPDC, 
REALTIME. GRAPH, 
CPEXEC, SYSSERV, 
MATHCOMP 




10004437L 


4-21 








































Table 4-1. SEL Database Tables and Views (20 of 21) 


Tabla or 
Vlaw Nam* 

Column Nama 

Daacriptlon 

Typ* 

Valid Coda/ Valua 

Rafaranca ID 

SUB COM 
(CONTD) 

SUBSYJD 

ID UNIQUELY IDENTIFY- 
ING EACH SUBSYSTEM 
(FROM TABLE 
PROJ_SUB) 

NUMBER 

(5,0) 




COM_NAME 

COMPONENT DE- 

CHAR (40) 


P51, P84, 



SCRIPTIVE NAME 


D53 


COM_ NO 

SURROGATE KEY AS- 
SIGNED TO REPRESENT 
UNIQUE SUBSY ID AND 
COM NAME COMBINA- 
TION 

NUMBER 

(7,0) 




COM_DATE 

DATE ON WHICH COM- 
PONENT IS ENTERED 
INTO DATABASE 

DATE 


P52, D2 

VALIDATION 


TABLE THAT IDENTIFIES 
VALID CODES USED IN 
VARIOUS FIELDS IN DA- 
TABASE AND PROVIDES 
DESCRIPTIONS FOR 
THEM 





F_NAME 

FIELD NAME FOR WHICH 

CHAR (20) 

SEE APPENDIX A FOR 




CODE IS VALID 

A DESCRIPTION OF 
ALL CODES AND 
VALUES 



CODE 

ABBREVIATED CODE 

CHAR (10) 




VALUE 

FULL DESCRIPTION OF 
CODE 

CHAR (75) 



V CLEAN- 
ROOM ACT 


VIEW CONTAINING PER- 
SONNEL ACTIVITY 
HOURS FROM CLPRFs 
(FROM TABLE EFF ACT) 
THAT ARE CONVERTED 
INTO PRF ACTIVITY 
HOURS 





EFFJD 

SAME AS EFF ID IN 
EFF_ACT 

NUMBER 

(10) 




ACTIVITY 

SAME AS ACTIVITY IN 
EFF_ACT 

CHAR (8) 




ACT_HR 

SAME AS ACT HR IN 
EFF_ACT 

NUMBER 



V CLEAN- 

ROOM 

PROJECTS 


VIEW THAT JOINS THE 
PROJECT, PROJ NOTES, 
AND PROJ MESSAGES 
TABLES 





PROJ_NAME 

SAME AS PROJ NAME IN 
PROJECT 

CHAR (8) 




10004437L 


4-22 




Table 4-1. SEL Database Tables and Views (21 of 21) 


Table or 
View Name 

Column Name 

Description 

Typ* 

Valid Code/ Value 

Reference ID 

V PROJ 
COM 


VIEW THAT JOINS THE 
PROJECT, PROJ SUB, 
AND SUB_COM TABLES 





PROJ_NAME 

SAME AS PROJ NAME IN 
PROJECT 

CHAR (8) 




SUB_PRE 

SAME AS SUB PRE IN 
PROJ_SUB 

CHAR (5) 




COM_NAME 

SAME AS COM NAME IN 
SUB_COM 

CHAR (40) 




COM_NO 

SAME AS COM NO IN 
SUB_COM 

NUMBER 

<7.0) 



V PROJ 
$UB_ ACT 


VIEW THAT JOINS THE 
PROJECT, EFF PROJ, 
EFF SUB, AND EFF ACT 
TABLES 





PROJ_NAME 

SAME AS PROJ NAME IN 
PROJECT 

CHAR (8) 




SUB_PRE 

SAME AS SUB PRE IN 
EFF_SUB 

CHAR (5) 




ACTIVITY 

SAME AS ACTIVITY IN 
EFF_ACT 

CHAR (10) 




ACT_HR 

SAME AS ACT HR IN 
EFF_ACT 

NUMBER 
(10, 2) 



V 

SUBSYSTEM 
_ INFO 


VIEW THAT JOINS THE 
PROJECT, PROJ SUB, 
AND SUBSYSTEM 
TABLES 





SUB_PRE 

SAME AS SUB PRE IN 
PROJ_SU8 

CHAR (5) 




NAME 

SAME AS NAME IN SUB- 
SYSTEM 

CHAR (40) 




FUNCTION 

SAME AS FUNCTION IN 
SUBSYSTEM 

CHAR (10) 




SUB_DATE 

SAME AS SUB DATE IN 
PROJECT 

DATE 




PROJ_NAME 

SAME AS PROJ NAME IN 
PROJECT 

CHAR (8) 




10004437L 
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4-2. SEL Database Tables and Views — Technical Specifications (1 of 30) 

Underlying Table Name 

USERCLASS 

USER_CLASS_ACCESS 

















« 

T3 

0 

X 

0 

-o 

C 

1 


U. INDEX 

INDEX 

INDEX 

1 

1 

1 

1 

1 






INDEX 


INDEX 

CM 

0 

3 

Z 

N. NULL 

N. NULL 

N. NULL 

N. NULL 

N. NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

N. NULL 

N. NULL 

T* 

>* 

0 

* 

PK 

1 

PK 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

Width 

20 

o 

CO 

5,0 

05 

1 

1 

o 

T— 

o 

1 


o> 

o> 

3,0 

2.0 

o 

<o 

o 

4> 

Q. 

CHAR 

CHAR 

CHAR 

NUMBER 

DATE 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

CHAR 

DATE 

DATE 

NUMBER 

NUMBER 

CHAR 

oc 

o 

CHAR 

Column Name 

ORAUSERJD 

3dAl SS300V 

ON 39NVH0 

PROGJD 

SUB_DATE 

EFF_ONE 

EFF_ADA 

EFF_ISO_CH 

EFF_COM_CH 

EFF_PARPA 

EFF_OTHER 

DATE_DETER 

DATE_COMP 

NUM_COM_CH 

NUM_COM_EX 

CHTYPE 

FORMTYPE 

STATUS 

Table < 

VAX Tables 

Table or View Name 

AUTHORIZE 

CHANGE 


1 00004437L 


4-24 


1 PK = PRIMARY KEY 
2 N. NULL = NOT NULL 
3 U. INDEX = UNIQUE INDEX 






















































































o 

CO 


o 

cm 

<0 

c 

o 


<0 

o 


o 

0) 

Q. 

CO 


<0 

o 


o 

£ 


<0 

5 

JD 

> 

■o 

c 

(0 

CO 

a> 

x> 

p 

a> 

co 

CO 

.Q 

CO 

CO 
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4.2 RELATIONSHIPS AND CONSTRAINTS AMONG DATABASE 
TABLES 

The SEL database is composed of two classes of information: the software engineering data 
itself, and the information describing those data and defining their organization within the 
database. The software engineering data are discussed in Sections 2 and 3. The descriptive 
and organizational information stored in various tables and referred to from here on as 
system support data are further described in this section. 

4.2.1 Relationships Among Tables 

In the SEL database, certain tables have relational dependencies among them. These depen- 
dencies among tables are important and need to be observed, especially when insert, update, 
or delete operations are performed. In a relationship, tables share common values existing in 
one or more columns of each table. For example, table PROJECT and table PROJ_SUB both 
share the same v alues of project number. When project data are first entered in the database , a 
record containing the project name, project type, and project status is created in the PROJ- 
ECT table. A unique project number is also assigned and stored in the same record. As the 
rest of the project data are collected, they are stored in various tables. The relationship 
between these tables and the PROJECT table is defined through the project number column. 
(See Figure 1-1 for an example of this relationship between the PROJECT and PROJ_SUB 
tables.) 

Figures 4-1 through 4-3 depict these relationships and represent them as tree structures. 
Figure 4-1 shows the relationships among project related data. Figure 4-2 shows the relation- 
ships among DAMSEL support tables. Figure 4-3 shows the relationships involving project- 
independent data. 

In these figures, each tree is a logical entity of related tables. The name shown within each 
block is a table name. The top node in each tree is the parent node, and the others are 
dependent (child) nodes. Each dependent node occurrence in the tree must have a record in 
its parent. For example, each record existing in table SUBSYSTEM that contains detailed 
subsystem information must first have been created in the PROJ_SUB table, since the record 
in the PROJ_SUB table contains the vital information — the project number and the subsys- 
tem prefix. The name(s) shown at the upper left comer of each block corresponds to the field 
name that links these tables together and can be used as a joining column. For example, field 
COM_NO can be specified in a WHERE clause for joining tables SUB COM and COM 
PURPOSE. If the common columns in both the parent and child tables have the same name, 
only one name is shown. Otherwise, both column names from these tables are shown and the 
notation “=” is used to show that they share common values. The left-hand side of the 
equality is the column name from the parent table; the right-hand side is the column name 
from the child table. For example, to join tables EFF PROJ and EFF_ACT in a SQL SELECT 
statement, the joining columns are P_ED from EFF_PROJ and EFF_ID from EFF_ACT. 

The relationships between data elements and tables are described in detail in Reference 2. 
However, some of these relationships are worth mentioning here so that the reader can 
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Figure 4-2. Relationships Among DAMSEL Support Tables 

understand how the data are logically divided and stored in the database. Observe that the 
data elements that compose each of the major data groups presented in Section 2 may reside 
in one or more tables, depending on the number of occurrences of a particular data element. 
For example, consider the component information within the structure and size data group. 
For each component of a project, all component-related data, such as origin, creation date, 
type, etc., reside in the COM_SOURCE table, with the exception of the component pur- 
poses. These reside in the COM_PURPOSE table because one component can have multiple 
purposes. This logical partitioning of data was performed during the database design process 
to ensure data integrity and minimize data redundancy. 

For the same reasons, staff hours information within the resource usage data group resides in 
different tables. Regular activity hours for all projects reside in the EFF_ACT table. The data 
elements required for retrieving project-related activity hours, such as project and program- 
mer IDs, are stored in the EFF_PROJ table. Additional data elements required for retrieving 
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Figure 4-3. Relationships Involving Project-Independent Data 


subsystem-related hours, such as subsystem prefixes, are stored in the EFF_SUB table. 
Using this arrangement can minimize data redundancy. As mentioned in Section 2, many 
projects do not have subsystem-related activity hours. Thus, depending on the project, the 
activity hours may be retrieved from the EFF_ACT table by directly joining it with the EFF_ 
PROJ table, or via the EFF_SUB table. These relationships are depicted as connected lines in 
Figure 4-1. 

As for staff hours recorded for projects using cleanroom methodology, they can be retrieved 
in one of two ways: as cleanroom PRF activity hours or as regular PRF activity hours. To 
retrieve hours under cleanroom PRF activities, join the EFF_ACT table with the EFF_PROJ 
table and specify the cleanroom activities. The cleanroom PRF activities are provided in 
Appendix A of this document or can be viewed in the database by selecting codes and values 
from the view VAL_CL_ACTTV IT Y. To retrieve hours under the regular PRF activities, join 
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. the view V_CLEANROOM_ACT with table EFF_PROJ. The mapping between the clean- 
room PRF activities and the regular PRF activities is as follows: 


Cleanroom PRF Activity/Code 

Predesign (CLPREDES) 

Create design (CLCREDES) 
Verify/Review design (CLVEREVDES) 
Write code (CLWRCODE) 
Read/Review code (CLRDREVCOD) 
Pretest + Independent test 
(CLPRETEST + CLINDTEST) 

Response to SFR (CLRESPSFR) 
Acceptance test (CLACCTEST) 

Other (CLOTHER) 


Regular PRF Activity/Code 

Predesign (PREDES) 

Create design (CREDES) 
Read/Review design (RDREVDES) 
Write code (WRCODE) 
Read/Review code (RDREVCOD) 
Integration test (INTTEST) 

Debugging (DEBUG) 

Acceptance test (ACCTEST) 

Other (OTHER) 


In addition, some of the tables are used as connectors to relate data items that reside in 
different tables. For example, consider the CHANGE_COM table within the change data 
group. It does not contain any SEL forms data. It only contains two surrogate key fields, 
change number and component number. The fields in this table can be used to connect the 
change data with the size and structure data (i.e., project and subsystem data items stored in 
various tables). Other tables, such as PROJ_SUB and SUB_COM, have a functionality 
similar to the CHANGE COM table. 


4.2.2 Descriptions of Support Data Tables 

The tables described in this section do not contain software engineering data. Rather, they are 
used to store data that are internal to the database structure and to store data that are used by 
the database operational software. 

CLOSE_COF 

This table is used during project closeout for verifying the accuracy and completeness of a 
project’s COFs. This temporary table is cleared, populated with all the component informa- 
tion for the specified project, queried, and cleared again. 

CLOSE_COM_NO_ORIGIN 

This table is used during project closeout for assigning a final “origin” category to each 
component. For most components the final “origin” is the same as the COF origin. However, 
any component with a COF origin of “Old and Unchanged” will be assigned a final “origin” 
of slightly modified if any CRFs were submitted for that component. 
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CLOSECRF 

This table is used during project closeout for verifying the accuracy and completeness of a 
project’s CRFs. This temporary table is cleared, populated with all the change information 
for the specified project, queried, and cleared again. 

CLOSE_CRF_ERR 

This table is used during project closeout for verifying the accuracy and completeness of a 
project’s CRFs with a change type of error correction (ERRCO). This temporary table is 
cleared, populated with all the information about changes due to errors for the specific 
project, queried, and cleared again. 

CRFTEMPCHANGECOM 

This table is used by the DAMSEL CRF data entry programs CRF_INSERT, CRF_UP- 
DATE, and CRF_QA. It contains the component information associated with the current 
CRF form. The information is uniquely identified with a USER ID, which is actually the 
SESSIONID of the current user. 

DUMMY 

This table is used by DAMSEL data entry programs. It is updated with null values during 
data entry to invoke, or trigger, certain sequences of operations to be performed. 

GENERATESATDAY 

This table is used in generating DAMSEL reports. It stores all the Saturday dates for reports 
that display weekly information. Once the dates are used by a report, the corresponding 
entries in this table are then deleted. 

PC_SEQNO 

This table is used by the DAMSEL DSF data entry software. The PROJ_DSF table contains 
two columns that are system -generated numeric IDs: D_ID and FORM_NO. The 
PC_SEQNO table stores the maximum value that already exists in PROJ_DSF for each of 
these fields. 

PERMSCRIPT 

This table is used in generating DAMSEL reports. It contains header information about the 
permanent report scripts. A report script is built during interactive report selection via 
DAMSEL. A script is identified by a script number and its owner’s ORACLE USER_ID. 

REPCODES 

This table is used as a look-up table by the DAMSEL menus and screens. It contains ail the 
possible report types, report titles, report codes, and project selection criteria. Each entry in 
the table contains a unique code and a descriptive value. The codes are stored, but the values 
are displayed on the screens so that users will understand the contents of a report script. 
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SCRIPT_PROJECTS 

This table is used in generating DAMSEL reports. It stores the names of the projects that are 
entered by a user for multiple-project repons with a REPORT_TYPE_S ELECTION (in 
table SCRIPT_REPORT) of “LIST.” The entries that arc created for temporary scripts are 
deleted once the report has been generated; the entries for permanent scripts are stored until 
the script owner deletes the script. 

SCRIPT_REPORT 

This table is used in generating DAMSEL reports. It contains the definitions of both tempo- 
rary and permanent scripts. The following information is stored for each report in a script: the 
report type (e.g., single-project or multiple-project); the report code, which identifies the 
report; the project(s) to be included in the report; and the report sequence number, which 
identifies the location of the report within the script. 

SEQNO 

This table is used by DAMSEL data entry programs. It stores the maximum values already 
used of all the system-generated IDs in the database. The following columns are system- 
generated IDs : 


Table Name 

Column Name 

EFF_PROJ 

P_ID 

EFF_SUB 

PS_ID 

MATNT_PROJ 

MAINTJD 

PERM_SCRIPT 

SCRIPT_NO 

PERSONNEL 

PROG_ID 

PROJECT 

PROJ_NO 

PROJ_NOTES 

SJD 

PROJ.SUB 

SUBSYJD 

SUB_COM 

COM_NO 

TEMP_SCRIPT 

SCRIPT_NO 


TABLE_PRIVILEGE 

This table is used in enrolling DAMSEL users. It defines the access privileges that each user 
class may be granted for each table in the database. The valid privileges are select, insert, 
update, delete, alter table structure, and create indices. 

TEMPACTIVTTY 

This table is used for producing the DAMSEL Programmer Activity Hours reports. It 
contains all of the possible activities for each week the project has been in a development 
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phase. For each activity and week, the total number of hours worked on the project is stored. 
To populate this table, the GENERATE_SAT_DAY table must first be populated with the 
correct Saturday dates. 

TEMPFORMCT 

This table is used for producing the DAMSEL Project Form Counts reports. It contains the 
total number of CRFs, COFs, and SPFs that have been entered since the project has been in a 
development phase. For each form type and week, the total number of forms entered is 
stored. 

TEMPMANHRS 

This table is used for producing the DAMSEL Manpower Hours reports. It contains all of the 
programmer names for each week the project has been in a development phase. For each 
programmer and week, the total number of hours worked is stored. To populate this table, the 
GENERATE SAT DAY table must first be populated with the correct Saturday dates. 

TEMP_SCRDPT 

This table is used in generating DAMSEL reports. It contains header information about the 
temporary report scripts that are created by each user during an interactive session. The script 
owner, his/her process ID, the script status, and other script-related information are stored in 
this table. The scripts are identified by script numbers. 

TEMP SERVHRS 

This table is used for producing the DAMSEL Services Hours reports. It contains all of the 
support names for each week the project has been in a development phase. For each support 
name and week, the total number of hours worked is stored. To populate this table, the 
GENERATE_SAT_DAY table must first be populated with the correct Saturday dates. 

T_C OM_STAT 

This table is used during project closeout to load the COM_STAT table. Records are loaded 
from a flat file into T_COM_STAT via SQL*Loader. The T_COM_STAT rows and 
SQL*Loader output are then verified by SEL personnel before the rows are inserted into 
COM_STAT. 

USER_CLASS 

This table is used in enrolling DAMSEL users. It contains all users’ ORACLE user IDs and 
their user class specifications. Currently, there are five types of user classes: general user, 
librarian, quality assurance (QA), SEL database administrator (DBA), and system mainte- 
nance user. 

USER_CLASS_ACCESS 

This table is used in enrolling DAMSEL users. For each user class specification, the types of 
functional access permitted are stored in this table. The current valid types of access are 
BACKUP, DBA, DELETE, DISTAPE, FORM, GENERAL, IMPORT, INSERT, QA, 
QUERY, REPORT, RESTORE, UPDATE, UPDOWN, AND VIEW. 
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VALIDATION 


This table stores all the codes and their corresponding detailed descriptions used by various 
tables throughout the database. (Appendix A provides a complete list of all the codes and 
their descriptions.) Fields that use coded values are listed below. 


Table or View Name 

CHANGE 

CHANGE 

CHANGE 

CHANGE 

CH_ADAFEAT 

CH_ERR_ARES 

CH_ERR_GEN 

CH_ERR_GEN 

CH_ERR_GEN 

CH_ERR_TOOLS 

COM_PURPOSE 

C OM_S OURCE 

COM_SOURCE 

COM_S OURCE 

COM_STAT 

DS F_ME AS URE 

DS F_ME AS URE 

DSF_TARGET 

DSF_TARGET 

EFF_ACT 

EFF_FORM 

MAINT_ACT_HRS 

MAINT_CHANGE 

MAINT_CHANGE 

MAINT_CHANGE 

MAINT_CHANGE 

MAINT_CHANGE 

MAINTCH OBJECTS 


Field Name 

CH_TYPE 

EFF_COM_CH 

EFF_ISO_CH 

STATUS 

ADA_FEATURE 

ERR_ARES 

ERR_ACAUSE 

ERR_CLASS 

ERR_SOURCE 

ERR_TOOLS 

PURPOSE 

COM_TYPE 

ORI_TYPE 

STATUS 

FINAL_ORIGIN_CAT 

MEASURE CODE 

STATUS_CODE 

STATUS_CODE 

TARGET_CODE 

ACTTVTTY 

STATUS 

MAINT_ACT 

CH_CAUSE 

CH_CLASS 

MAINT_CH_TYPE 

MAINT_COM_CH 

MAINT_ISO_CH 

CH_OBJECT 
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Table or View Name 

Field Name 

MAINT_CL AS S _HRS 

MAINT_CLASS 

PROJECT 

ACTIVE_STATUS 

PROJECT 

PROJJTYPE 

PRO J_EST_PHAS E 

PHASE_CO 

PROJ_FORM 

STATUS 

PROJ_NOTES 

NOTE_TYPE 

PROJ_SEF 

MEAS_TYPE 

PRO J_S EF_S EC 

SECONDJL 

SPECIAL_ACT 

SP_ACnVITY 

SUBSYSTEM 

FUNCTION 

VAL_CL_ACTIVTTY 

CL_AcnvrrY 

VAL_DATA_AVAIL 

DATA_AVAIL 

VAL_QA_STATUS 

QA.STATUS 


4.2.3 Database Constraints 

Various constraints are associated with the database. Constraints are defined to ensure that 
the database contains only accurate and consistent data and to protect the data against 
unauthorized or accidental alterations. In the SEL database environment, constraints are 
identified as access constraints or data integrity constraints. Access constraints are 
associated with each user class and are defined as follows: 

• General user — Has read access to all data 

• Data librarian — Has read, write, and update access to the form-related data 

• QA — Has read and update access to certain form related data 

• DBA — Has read, write, and update access to all data 

• System maintenance — Has read access to all data, and read, write, and update ac- 
cess to system support data 

Data integrity constraints are applied to all insertions to, deletions from, and updates of the 
database. Table 4-3 describes these constraints. They are used not only in SQL queries, but 
also in the DAMSEL data entry software. Table 4-3 lists only the database tables that have 
constraints. In addition to these constraints, field EFF_ID in table EFF_ACT and table 
SPECIAL_ACT contains values from both the P_ED field (in table EFF_PROJ) and the 
PS ID field (in table EFF_SUB). This constraint is accommodated by assigning mutually 
exclusive values for P_ID and PS_ID. 
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4.3 MAPPING THE CONCEPTUAL VIEW TO THE LOGICAL 
VIEW 

This section presents a schema, shown in Table 4-4 (at the end of the section), that maps both 
the conceptual and the data collection views of the SEL data described in Sections 2 and 3 to a 
unified logical view. The schema is intended to provide general users who would like to 
retrieve data using SQL queries with more detailed information on how to get to the desired 
data. By using this schema, along with the specific instructions on how to access SQL*Plus 
in the SEL database environment (provided in Section 5.3), general users can set up their 
own queries to look at the data in their own specific ways. 

Table 4-4 lists all the reference IDs used in Sections 2 and 3 that identify the data items in the 
database and presents the name of the table and the column where that data item is stored. 
This table is ordered by target table and target column. 

Required access information, needed to obtain a particular piece of data, is also provided for 
each reference ID. Under the columns ‘TARGET TABLE” and “TARGET COLUMN” is 
the table/field from which data are being retrieved. For example, to retrieve the activity hours 
for a particular programmer (see Table 4^4, under TARGET TABLE EFF_ACT and TAR- 
GET COLUMN ACT_HR), the project name, the programmer name, and the week ending 
date on the PRF must be provided before the appropriate activity hours can be retrieved. 

Under the heading “Access Path,” there is a graph-like diagram showing the access path that 
a SQL query may traverse to retrieve the desired data. The path shown is just one of the many 
possible ways to get to the data; other paths can be used to achieve the same result. In each 
access path, the names within square brackets [ ] represent column names. The names with 
no brackets around them represent table names. The arrows point to either an intermediate 
table or the final target column. The name of each target field that stores coded values is 
followed by the keywords “*CODED FIELD.” The codes and their descriptions are ex- 
plained in Appendix A. In addition, symbol “!=” means not equal to and MAX means the 
maximum value of the column that follows. 

Using the access paths in Table 4-4, the corresponding SQL queries can be formulated easily. 
The following three examples demonstrate how to interpret the access path diagrams. They 
also show that some of the access paths may retrieve a single record from a target table and 
others may retrieve multiple records. In the first example, the access path will return one 
record if one subsystem exists for the specified project; multiple records if more than one 
subsystem exists; or null if no subsystems exist. In the second example, the access path will 
return a single record that contains the creation date for the component specified by the user. 
However, this access path can be modified to retrieve all the creation dates for all compo- 
nents in a particular subsystem within a particular project. This can be accomplished by not 
specifying the component name in the SQL query. The third example retrieves the same 
information as example 2. The difference is that a view is joined to one table to simplify the 
query and eliminate the need to join four tables. 
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Table 4-3. Constraints on Database Tables (1 of 6) 


Table 

Constraint 

CHANGE 

THE CRF FORM NUMBER (CHANGE_NO) MUST BE UNIQUE WITHIN THIS TABLE. 

THE PROGRAMMER ID (PROGJD) MUST EXIST IN THE PERSONNEL TABLE. 

THE EFFORT TO ISOLATE CHANGES CODE (EFF_ISO_CH) MUST EXIST IN THE 
VAL_ISO_CH VIEW. 

THE EFFORT TO IMPLEMENT CHANGES CODE (EFF_COM_CH) MUST EXIST IN THE 
VAL_COM_CH VIEW. 

THE TYPE OF CHANGE (CH_TYPE) MUST EXIST IN THE VAL_CH_TYPE VIEW. 

THE FORM TYPE (FORM_TYPE) MUST EQUAL CRF. 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. 

CHANGE_COM 

THE CRF FORM NUMBER (CHANGE_NO) MUST EXIST IN THE CHANGE TABLE. 

THE COMPONENT NUMBER (COM_NO) MUST EXIST IN THE SUB_COM TABLE. 

CH_ADAFEAT 

THE CRF FORM NUMBER (CHANGE NO) MUST EXIST IN THE CHANGE TABLE, AND THE 
FLAG INDICATING WHETHER THE USE OF ADA CONTRIBUTED TO THE CHANGE 
(EFF_ADA) IN THE CHANGE TABLE MUST EQUAL T FOR THAT CHANGE. 

THE ADA FEATURE CODE (ADA FEATURE) MUST EXIST IN THE VAL_ADA_FEATURE 
VIEW. 

CH_ERR_ARES 

THE CRF FORM NUMBER (CHANGE NO) MUST EXIST IN THE CHANGE TABLE, THE 
TYPE OF CHANGE (CH TYPE) IN THE CHANGE TABLE MUST EQUAL 'ERRCO' FOR THAT 
CHANGE, AND EFF_ADA MUST EQUAL 'Y' 

THE CODE REPRESENTING THE RESOURCE NEEDED TO CORRECT AN ADA ERROR 
(ERR_ARES) MUST EXIST IN THE VAL_ERR_ARES VIEW. 

CH_ERR_GEN 

THE CRF FORM NUMBER (CHANGE NO) MUST EXIST IN THE CHANGE TABLE, AND THE 
TYPE OF CHANGE (CH TYPE) IN THE CHANGE TABLE MUST EQUAL ‘ERRCO’ FOR THAT 
CHANGE. 

THE SOURCE OF ERROR CODE (ERR SOURCE) MUST EXIST IN THE 
VAL_ERR_SOURCE VIEW. 

THE CLASS OF ERROR CODE (ERR CLASS) MUST EXIST IN THE VAL_ERR_CLASS 
VIEW. 

THE CODE FOR THE CAUSE OF AN ERROR INVOLVING ADA (ERR_ACAUSE) MUST EX- 
IST IN THE VAL_ERR_ACAUSE VIEW. 

CH_ERR_TOOLS 

THE CRF FORM NUMBER (CHANGE NO) MUST EXIST IN THE CHANGE TABLE, THE 
TYPE OF CHANGE (CH TYPE) IN THE CHANGE TABLE MUST EQUAL ‘ERRCO’ FOR THAT 
CHANGE. AND EFF_ADA MUST EQUAL T. 

THE CODE FOR ADA TOOLS AIDING IN THE DETECTION OR CORRECTION OF AN ER- 
ROR (ERR_TOOLS) MUST EXIST IN THE VAL_ERR_TOOLS VIEW. 

COMPUTER 

THE COMPUTER NAME (CPU_NAME) MUST BE UNIQUE WITHIN THIS TABLE. 

COM_PURPOSE 

THE COMPONENT NUMBER (COM_NO) MUST EXIST IN THE SUB_COM TABLE. 

THE COMPONENT PURPOSE (PURPOSE) MUST EXIST IN VAL_COM_PURPOSE VIEW. 

COM_SOURCE 

THE COMPONENT NUMBER (COM_NO) MUST EXIST IN THE SUB_COM TABLE. 

THE PROGRAMMER ID (PROGJD) MUST EXIST IN THE PERSONNEL TABLE. 

THE COF NUMBER (FORM_NO) MUST BE UNIQUE WITHIN THIS TABLE. 

THE FORM TYPE (FORMJYPE) MUST EQUAL ‘COP. 
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Table 4-3. Constraints on Database Tables (2 of 6) 


Table 

Constraint 

COM SOURCE 
(CONT’D) 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. 

THE ORIGIN OF A COMPONENT CODE (ORI TYPE) MUST EXIST IN THE VAL ORI TYPE 
VIEW. ~ _ 

THE COMPONENT TYPE CODE (COM _TYPE) MUST EXIST IN THE VAL_COM_TYPE VIEW. 

COM_STAT 

THE COMPONENT NUMBER (COM_NO) MUST EXIST IN THE SUB_COM TABLE. 

CRF TEMP 
CHANGE_.COM 

THE SUBSYSTEM PREFIX (SUB_PRE) MUST EXIST IN THE PROJ_SU8 TABLE. 

THE COMPONENT NAME (COM_NAME) MUST EXIST IN THE V_PROJ_COM VIEW. 

THE COMPONENT NUMBER (COM_NO) MUST EXIST IN THE V_PROJ_COM VIEW. 

DSF_MEASURE 

THE D_ID MUST EXIST IN THE PROJ_DSF TABLE. 

THE DSF STATUS CODE (STATUS_CODE) MUST EXIST IN THE VAL_DSF_STATUS VIEW. 

THE DSF MEASURE CODE (MEASURE CODE) MUST EXIST IN THE VAL DSF MEASURE 
VIEW. 

DSFJTARGET 

THE DJD MUST EXIST IN THE PRQJ_DSF TABLE. 

THE DSF STATUS CODE (STATUS_CODE) MUST EXIST IN THE VAL_DSF_STATUS VIEW. 

THE DSF TARGET CODE (TARGET_CODE) MUST EXIST IN THE VAL_DSF TARGET VIEW. 

EFFECT 

THE EFFJD MUST EXIST IN THE EFF SUB (AS PS ID) OR IN THE EFF PROJ (AS P ID) 
TABLE. ~ 

THE ACTIVITY CODE (ACTIVITY) MUST EXIST IN THE VAL_ACT!VITY VIEW. 

EFF^FORM 

THE P_ID MUST EXIST IN THE EFF_PROJ TABLE. 

THE FORM TYPE (FORMJYPE) MUST BE ‘CLPRF, 'PRF', OR 'SPF'. 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. 

EFF_PROJ 

THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

THE SUBMISSION DATE (SUB_DATE) MUST BE A VALID FRIDAY DATE. 

THE PROGRAMMER ID (PROGJD) MUST EXIST IN THE PERSONNEL TABLE. 

THE PJD MUST BE UNIQUE WITHIN THIS TABLE. 

EFF_SUB 

THE PJD MUST EXIST IN THE EFF_PROJ TABLE. 

THE SUBSYSTEM PREFIX (SUB_PRE) MUST EXIST IN THE PROJ_SUB TABLE. 

THE PSJD MUST BE UNIQUE WITHIN THIS TABLE. 

GENERATE 

SAT_DAY 

THE REPORT SCRIPT NUMBER (SCRIPT_NO) MUST EXIST IN THE TEMP_SCRIPT TABLE. 

THE DATE (SAT_DAY) MUST BE A VALID SATURDAY DATE. 

MAINT_ACT_ HRS 

THE MAINTJD MUST BE IN THE MAINT_PROJ TABLE. 

THE MAINTENANCE ACTIVITY CODE (MAINT ACT) MUST EXIST IN THE VAL MAINT ACT 
VIEW. 


THE COMBINATION OF THE MAINTJD AND MAINT_ACT MUST BE UNIQUE. 

MAINT_CHANGE 

THE MAINTENANCE CHANGE NUMBER (MAINT CH NO) MUST BE UNIQUE WITHIN THIS 
TABLE. [ 
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Table 4-3. Constraints on Database Tables (3 of 6) 

Table Constraint 

MAINT_CHANGE THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

(CONT’D) 

THE PROGRAMMER ID (PROG _ID) MUST EXIST IN THE PERSONNEL TABLE. 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. ” 

THE FORM TYPE (FORM_TYPE) MUST BE 'MCRF'. 

THE TYPE OF CHANGE (MAINT CHJTYPE) MUST EXIST IN THE VAL_M A I NT_C H_TY P E 
VIEW. 

THE CAUSE OF CHANGE (CH_CAUSE) MUST EXIST IN THE VAL_CH_TYPE VIEW. 

THE EFFORT TO ISOLATE CHANGES CODE (MAINT_ISO_CH) MUST EXIST IN THE 
VAL_MAINT_ISO_CH. 

THE EFFORT TO IMPLEMENT CHANGES CODE (MAINT_COM_CH) MUST EXIST IN THE 
VAL_MAINT_COM_CH VIEW. 

THE CHARACTERISTIC OF CHANGE (CH_CLASS) MUST EXIST IN THE VAL_CH_CLASS 
VIEW. 

MAINT_CH_ THE MAINTENANCE CHANGE NUMBER (MAINT_CH_NO) MUST EXIST IN THE 

OBJECTS MAINT_CHANGE TABLE. 

THE CHANGE OBJECTS (CHJDBJECT) MUST EXIST IN THE VAL_CH_OBJECT VIEW. 

MAINT_CLASS_HRS THE MAINTJD MUST BE IN T HE MAINT_PROJ TABLE. 

THE CLASS OF MAINTENANCE (MAINT_CLASS) MUST EXIST IN THE VAL_MAINT_CU\SS 
VIEW. 

THE COMBINATION OF THE MAINTJD AND MAINT_CLASS MUST BE UNIQUE. ” 
MAINT_PROJ THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

THE SUBMISSION DATE (SUB_DATE) MUST BE A VALID FRIDAY DATE. 

THE PROGRAMMER ID (PROGJD) MUST EXIST IN THE PERSONNEL TABLE. 

THE MAINTJD MUST BE UNIQUE WITHIN THIS TABLE. 

THE FORM TYPE (FORM_TYPE) MUST BE 'WMEF. 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. ”™ 

PC_SEQNO THE TABLE NAME (TABLE_NAME) MUST EXIST IN THE DATABASE. 

THE FIELD NAME (FIELD_NAME) MUST EXIST IN THAT PARTICULAR TABLE. ~ 

PERM_SCRIPT THE ORACLE USER ID (ORA_USER) MUST EXIST IN THE USER_CLASS TABLE. ” 

THE SCRIPT NUMBER (SCRIPT_NO) MUST BE UNIQUE WITHIN THIS TABLE. 

THE OUTPUT DESTINATION (OUT_ROUTING) MUST BE 'P' FOR PRINTER OR F FOR 
FILE. 

THE OUTPUT FILE NAME (OUT_FILE) MUST BE ENTERED IF OUT_ROUTING EQUALS F 

PERSONNEL THE ABBREVIATED NAME USED ON FORMS (FORM_NAME) MUST BE UNIQUE WITHIN 

THIS TABLE. 

THE PROGJD MUST BE UNIQUE WITHIN THIS TABLE. ” 

PROJECT THE PROJECT NAME (PROJ_NAME) MUST BE UNIQUE WITHIN THIS TABLE. 

THE PROJECT NUMBER (PROJ_NO) MUST BE UNIQUE WITHIN THIS TABLE. 
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Table 4-3. Constraints on Database Tables (4 of 6) 


PROJ SEF SEC 


PROJ_STAT 


PROJ SUB 


Constraint 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE COMPUTER NAME (CPU_NAME) MUST EXIST IN THE COMPUTER TABLE. 


PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

THE SUBMISSION DATE (SU8_DATE) MUST BE A VALID FRIDAY DATE. 

THE PROGRAMMER ID (PROGJD) MUST EXIST IN THE PERSONNEL TABLE. 
THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. 

THE FORM TYPE (FORM_TYPE) MUST BE DSF\ 

THE 0_ID MUST BE UNIQUE WITHIN THIS TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE PHASE CODE (PHASE_CO) MUST EXIST IN THE VAL_PHASE VIEW. 


THE PHASE START DATE (START_DATE) AND END DATE (END DATE) MUST BE VALID 
SATURDAY DATES. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

THE FORM NUMBER (FORM_NO) MUST BE UNIQUE WITHIN THIS TABLE FOR A PARTIC- 
ULAR FORM TYPE. 

THE FORM TYPE (FORM_TYPE) MUST BE PCSF. PEF, 'SEF. ‘SPF. 

THE STATUS CODE (STATUS) MUST EXIST IN THE VAL_STATUS VIEW. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE SUBMISSION DATE (SUB_DATE) MUST BE A VALID FRIDAY DATE. 


THE S_ID MUST EXIST IN THE PROJ_NOTES TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE MESSAGE TYPE (NOTE_TYPE) MUST EXIST IN THE VAL_NOTE_TYP E VIEW. 


THE S_ID MUST BE UNIQUE WITHIN THIS TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE SUBMISSION DATE (SUB_DATE) MUST BE A VALID FRIDAY DATE. 


THE COMPUTER NAME (RES_NAME) MUST EXIST IN THE COMPUTER TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE SUBJECTIVE EVALUATION MEASUREMENT (MEAS TYPE) MUST EXIST IN THE 
VAL_MEAS_TYPE VIEW. 


THE SUBJECTIVE EVALUATION MEASUREMENT (MEAS TYPE) AND THE PROJECT 
NUMBER (PROJ_NO) MUST EXIST IN THE PROJ_SEF TABLE. 


THE SECONDARY-LEVEL INFORMATION MEASUREMENT CODES (SECOND L) MUST 
EXIST IN THE VAL_SECOND_L VIEW. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 


THE SUBSYSTEM PREFIX (SUB_PRE) MUST BE UNIQUE WITHIN THIS TABLE FOR A 
PARTICULAR PROJ_NO. 
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Table 4-3. Constraints on Database Tables (5 of 6) 


Table Constraint 

PROJ_SUB THE SUBSYSTEM ID (SUBSYJD) MUST BE UNIQUE WITHIN THIS TABLE. 

(CONf'D) ' 

SCRIPT PROJECTS THE SCRIPT NUMBER (SCRIPT_NO) AND THE REPORT SEQUENCE NUMBER (RE- 
PORT_SEQ) MUST EXIST IN THE SCRIPT_REPORT TABLE. 

THE PROJECT NAME (PROJ_NAME) MUST EXIST IN THE PROJECT TABLE. 

SCRIPT_ REPORT THE SCRIPT NUMBER (SCRIPT_NO) MUST EXIST IN EITHER THE PERM_SCRIPT OR 
THE TEMP_SCRIPT TABLE. 

THE REPORT CODE (REPORT_CODE) MUST EXIST IN THE VAL_REPORT_CODE TaIlE. | 

THE REPORT TYPE CODE (REPORT JTYPE) MUST BE ‘S’ FOR SINGLE PROJECT RE- 
PORT. 'M' FOR MULTIPLE-PROJECT REPORT, OR •O’ FOR MISCELLANEOUS REPORT. 

ip REPORT TYPE EQUALS 'S', THE VALID VALUES FOR REPORT_TYPE_SELECTION 
ARE VALID PROJECT NAMES (PROJ_NAME) IN THE PROJECT TABLE. IF REPORT_TYPE 
EQUALS 'M', THE VALID VALUES FOR REPO RT_TY PE_SELECTION ARE 'ALL 1 , 'ACT_DEV', 
•ACT_MAINT-, INACTIVE', AND LIST’. IF REPORTJYPE EQUALS 'O', THE REPORT TYPE 
SELECTION IS NULL. 

SEQNO THE TABLE NAME (TABLS_NAM E) MUST EXIST IN THE DATABASE. 

THE FIELD NAME (FIELD_NAME) MUST EXIST IN THAT PRTICULAR TABLE. 

SPECIAL_ACT THE EFFJD MUST EXIST IN EITHER THE EFF_PROJ (AS P_ID) OR THE EFF_SUB (AS 

PSJD) TABLE. 

THE SPECIAL ACTIVITY CODE (SP_ACTIVITY) MUST EXIST IN THE VAL_SP_ACTIVITY 
VIEW. 

SUBSYSTEM THE SUBSYSTEM ID (SUBSYJD) MU ST EXIST IN THE PROJ_SUB TABLE. 

THE SUBSYSTEM FUNCTION (FUNCTION) MUST EXIST IN THE VAL_S_FUNCTION VIEW. 

SUB_COM THE SUBSYSTEM ID (SUBSY_ID) M UST EXIST IN THE PROJ_SUB TABLE. 

THE COMPONENT NAME (COM_NAME) MUST BE UNIQUE WITHIN THIS TABLE FOR A 
PARTICULAR SUBSYSTEM. 

THE COMPONENT NUMBER (COM_NO) MUST BE UNIQUE WITHIN THIS TABLE. 

TA8LE_ PRIVILEGE THE TABLE NAME (TABLE_NAME) MUST EXIST IN THE DATABASE. 

THE USER CLASS (USER_CLASS) MUST EXIST IN THE USER_CLASS TABLE. 

TEMP ACTIVITY THE SCRIPT NUMBER (SCRIPT_NO) AND SATURDAY DATE (SAT_DAY) MUST EXIST IN 
THE GENE RATE_S AT_DAY TABLE. 

THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

TEMP_FORMCT THE SCRIPT NUMBER (SCRIPT_NO) MUST EXIST IN THE TEMPJ5CRIPT TABLE. 

THE PROGRAMMER ID (PROG JD) MUST EXIST IN THE PERSONNEL TABLE. 

THE PROJECT NUMBER (PROJ_NO) MUS T EXIST IN THE PROJECT TABLE. 

TEMP_MANHRS THE SCRIPT NUMBER (SCRIPT_NO) AND SATURDAY DATE (SAT_DAY) MUST EXIST IN 
THE GENERATE_SAT_DAY TABLE. 

THE PROGRAMMER ID (PROGJD) MUST EXIS T IN THE PERSONNEL TABLE. 

THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE. 

THE P ID MUST EXIST IN THE EFF_PROJ TABLE. 
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Table 4-3. Constraints on Database Tables (6 of 6) 


Table 

Constraint 

TEMP SCRIPT 

THE SCRIPT NUMBER (SCRIPT_NO) MUST BE UNIQUE WITHIN THIS TABLE. 

THE ORACLE USER ID (ORAJJSER) MUST EXIST IN THE USER_CLASS TABLE. 

THE OUTPUT DESTINATION (OUT ROUTING) MUST BE 'P' FOR PRINTER OR F' FOR 
FILE. 

THE OUTPUT FILE NAME (OUT_FILE) MUST BE ENTERED IF OUT_ROUTING EQUALS F . 

TEMPOS ERVHRS 

THE SCRIPT_NO AND SAT.DAY MUST EXIST IN THE GENERATE_SAT_DAY TABLE. 

THE PROGRAMMER ID (PROG ID) MUST EXIST IN THE PERSONNEL TABLE. 

THE PROJECT NUMBER (PROJ_NO) MUST EXIST IN THE PROJECT TABLE 

THE P_ID MUST EXIST IN THE EFF_PROJ TABLE. 

USER_CLASS 

THE ORACLE USER ID (ORA USER ID) MUST BE A VALID ORACLE USER ACCOUNT 
NAME. 

THE CLASS OF USER (USER CLASS) MUST EXIST IN THE USER CLASS ACCESS 
TABLE. 


Example 1 

This example retrieves all the subsystem prefixes of a particular project. This access path is 
shown in Table 4 -4 under target table PROJ_SUB and target column SUB_PRE and is as 
follows: 


[PROJ_NAME] 


PROJECT 


I 

PROJ_SUB 

I 


[SUB_PRE] 


[PROJ_NO] 


The first line in the access path shows that PROJ_NAME is the field whose value must be 
specified by the user to identify which project’s data are to be retrieved. The down arrow 
between PROJECT and PROJ SUB means that the two tables are joined together by a 
common field, which is listed next to the arrow (PROJ_NO, in this case). The down arrow 
under PROJ SUB points to the target column SUB_PRE of table PROJ_SUB, where all the 
subsystem prefixes are stored. 

SQL statement 

SQL> SELECT SUB_PRE FROM PROJ_SUB, PROJECT 

2 WHERE PROJ_SUB. PROJ_NO = PROJECT. PROJ_NO 

3 AND PROJ_NAME = <user-supplied project name>; 
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Example 2 


This example retrieves the date on which a component was entered into the project’s con- 
trolled library. The access path for this example is shown in Table 4-4 under target table 
COM_SOURCE and target column C RE ATE_D ATE and is as follows: 


[PROJ.NAME] 

[SUB_PRE] 

[COM_NAME] 


■* PROJECT 


T 


PROJ SUB 


▼ 


SUB COM 


▼ 


COM SOURCE 


y 


[CREATE_DATE] 


[PROJ_NO] 

[SUBSYJD] 

[COM_NO] 


PROJ_NAME, SUB_PRE, and COM_NAME are the fields whose values must be provided 
by the user. Tables PROJECT and PROJ_SUB are joined on PROJ_NO; PROJ_SUB and 
SUB COM are joined on SUBSY_ID; and SUB_COM and COM_SOURCE are joined on 
COMJMO. The result is field CREATE_DATE of the COM_SOURCE table. 


SQL statement 


SQL> 

2 

3 

4 

5 

6 

7 

8 


SELECT CREATE_DATE 

FROM COM_SOURCE, SUB_COM, PROJ_SUB, PROJECT 
WHERE COM_SOURCE. COM_NO = SUB_COM. COM_NO 
AND SUB_COM.SUBSYS_ID = PROJ_SUB.SUBSY_ID 

AND PROJ_SUB. PROJ_NO = PROJECT. PROJ_NO 

AND PROJ_NAME = cuser-supplied project name> 

AND SUB_PRE = cuser-supplied subsystem prefix> 

AND COM_NAME = cuser-supplied component name>; 
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Example 3 


This example uses a predefined view as an alternative to the method presented in example 2 
to get the same data (i.e., the date on which a component was entered into the controlled 
library). The access path for using the view V_PROJ_COM to retrieve this data item is as 
follows: 


COM_NAME 

1 

[PROJ_NAME] > V_PROJ_COM < [SUB_PRE] 

| [COM_NO] 

COM_SOURCE 

I 

[CREATE_DATE] 


In this example, view V_PROJ_COM replaces tables PROJECT, PROJ_SUB, and 
SUB_COM used in the previous example. The view already joins these tables. The result is 
field CREATE_DATE of the COM_SOURCE table. 

SQL statement 

SQL> SELECT CREATE_DATE 

2 FROM V_PROJ_COM, COM_SOURCE 

3 WHERE V_PROJ_COM.COM_NO = COM_SOURCE.COM_NO 

4 AND COM_NAME = <user- supplied component name> 

5 AND SUB_PRE = <user-supplied subsystem prefix> 

6 AND PROJ_NAME = <user-supplied project name>; 

The SQL statements in these examples are included for completeness. For a more detailed 
introduction to formulating SQL queries, see Section 5.3. 
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Table 4-4. SEL Database Access Paths (1 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P63, D82 

CHANGE 

CHANG E_NO 

PROJECT NAME 

[PROJ_NAME] -> V_PROJ_COM 

^ [COM_NO] 

CHANGE_COM 

^ [CHANGE_NO] 

CHANGE -► [CHANGE_NO] 

P76, D67 

CHANGE 

CH_TYPE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO) -► CHANGE 

^ 1 

[CH_TYPE]*CODED FIELD 

P73, D64 

CHANGE 

DATA_COMP 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO] -> CHANGE 
1 

[DATE_COMP] 

P72, D63 

CHANGE 

DATE_DETER 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO] -> CHANGE 

1 

[DATE_DETER] 

P69, D76 

CHANGE 

EFF_ADA 

i 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 

NUMBER 

. 

[CHANGE NO] -> CHANGE 

i 

[EFF_ADA] 

P67, D66 

CHANGE 

! 

EFF_COM_CH 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE_NO] -> CHANGE 

1 

[EFF_COM_CH]*CODED FIELD] 

P66, D65 

CHANGE 

EFFJSO_CH 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO]-* CHANGE 

i 

[EFF_ISO_CH]*CODED FIELD] 
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Table 4*4. SEL Database Access Paths (2 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P68, 068 

CHANGE 

EFF_ONE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]-> CHANGE 
1 

[EFF_ONE] 

P70, 069 

CHANGE 

EFF_OTHER 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]-> CHANGE 

i 

[EFF_OTHER] 

P71, D70 

CHANGE 

EFF_PARPA 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]— ► CHANGE 
1 

[EFF_PARPA] 

P74 

CHANGE 

NUM COM 
CH 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO]-> CHANGE 
1 

[NUM_COM_CH] 

P75 

CHANGE 

NUM COM 
EX 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

f [CHANGE NO]-> CHANGE 
1 

(NUM_COM_EX] 

P65, D2 

CHANGE 

SUB_DATE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]-> CHANGE 
1 

[SUB_DATE] 

P85, D77 

. 

CH 

ADAFEAT 

ADA 

FEATURE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]— ► CH ADAFEAT 
1 

[ADA_FEATURE]*CODED FIELD 
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Table 4-4. SEL Database Access Paths (3 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

P86, D80 

CH ERR 
ARES 

ERR_ARES 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P83, D79 

CH ERR 
GEN 

ERR_ACAUSE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P82, D78 

CH ERR 
GEN 

ERR_ADOC 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P78, D72 

CH ERR 
GEN 

ERR_CLASS 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P79, D74 

CH ERR 
GEN 

ERR_COMIS 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P80, D73 

CH ERR 
GEN 

ERR_OMIS 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

P77, D71 

CH ERR 
GEN 

ERR 

SOURCE 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 


Access Path 


[CHANGE_NO]-> CH_ERR_ARES 

[ERR_ARES]*CODED FIELD 


[CHANGENO] -> CH_ERR_GEN 

(ERR_ACAUSE]*CODED FIELD 


[CHANGE_NO]-> CH_ERR_GEN 
[ERR_ADOC] 


[CHANGENO] — ► CH_ERR_GEN 

i 

[ERR_CLASS]*CODED FIELD 


[CHANGE_NO]-> CH_ERR_GEN 
[ERR_COMIS] 


[CHANGE_NO]-> CH_ERR_GEN 
[ERR_OMIS] 


[CHANGE_NO]— ► CH_ERR_GEN 

[ERR_SOURCE]*CODED FIELD 
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Table 4-4. SEL Database Access Paths (4 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P81, D75 

CH ERR 
GEN 

ERRJTYPO 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

(CHANGE NO]-> CH ERR GEN 

'1 ' 
[ERRJTYPO] 

P87, D81 

CH ERR 
TOOLS 

ERR_TOOLS 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE NO)-* CH ERR TOOLS 

i ‘ 

[ERR_TOOLS]*CODED FIELD 

M4 

COMPU- 

TER 

CPU_NAME 

NONE 

COMPUTER ->• [CPU_NAME] 

MS 

COMPU- 

TER 

C FULL 
NAME 

NONE 

[CPU_NAME]— ► COMPUTER— ► [C_FULL_NAME] 

P59, 058 

COM 

PURPOSE 

PURPOSE 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ (SUBSY_ID] 

[COM_NAME] — ► SUB_COM 

^ [COM_NO] 

COM PURPOSE 

i 

[PURPOSE]*CODED FIELD 

P58 f D57 

COM 

SOURCE 

COM_TYPE 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

1 [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

1 [SUBSY_I D] 

[COM_NAME] — ► SUB_COM 

1 [COM_NO] 

COM SOURCE 

i 

[COM_TYPE]*CODED FIELD 
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Table 4-4. SEL Database Access Paths (5 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P53, D54 

COM 

SOURCE 

CREATE 

DATE 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — > PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ [SUBSY_ID] 

[COM_NAME] -> SUB_.COM 

^ [COM_NO] 

COM SOURCE 

i 

[CREATE_DATE] 

P57, D55 

COM 

SOURCE 

i 

1 

DIFFICULTY 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ [SUBSY_ID] 

[COM_NAME] — > SUB_COM 

^ [COM_NO] 

COM SOURCE 

i 

[DIFFICULTY] 

D59 

COM 

SOURCE 

FORM_NO 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

1 [SUBSYJD] 

[COM_NAME] — ► SUB_COM 

1 (COM_NO] 

COM SOURCE 

i 

[FORM_NO] 


10004437L 


4-77 
















Table 4-4. SEL Database Access Paths (6 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P56, D56 

COM 

SOURCE 

ORIJTYPE 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ [SUBSYJD] 

{COM_NAME] —> SUBJSOM 

^ (COM_NO) 

COM SOURCE 

1 

[ORI_TYPE]*CODED FIELD 

P54, D2 

COM 

SOURCE 

SUB_DATE , 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — ► PROJECT 

j [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ [SUBSYJD] 

[COM_NAME] — ► SUB_COM 

1 [COM NO] 

COM SOURCE 

i 

[SUB_DATE] 

PI 56 

COM 

STAT 

C_C_LINE 

PROJECT NAME 
AND COM- 
PONENT NAME 

[PROJ_NAME]-> V_PROJ_COM-4- [COM_NAME] 
^ [COM_NO] 

COM STAT 

i 

C_C_LINE 

PI 54 

COM 

STAT 

C_EXE_S 

L 

PROJECT NAME 
AND COM- 
PONENT NAME 

[PROJ_NAME]— ► V_PROJ_COM<— [COM_NAME] 
1 [COM_NO] 

COM STAT 

i 

[C_EXE_S] 


10004437L 


4-78 


















Table 4-4. SEL Database Access Paths (7 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P155 

COM 

STAT 

C_LINE 

PROJECT NAME 
AND COM- 
PONENT NAME 

[PROJ_NAME]-> V_PROJ_COM-<- [COM_NAME] 
^ [COM_NO] 

COM STAT 

i 

[C_LINE] 

P221 

COM 

STAT~ 

C_STMT 

PROJECT NAME 
AND COM- 
PONENT NAME 

[PROJ_NAME]— ► V_P RO J_C O M-<— [COM_NAME] 
^ [COM_NO] 

COM STAT 

i 

[C_STMT] 

P222 

COM 

STAT 

FINAL 

ORIGIN^CAT 

PROJECT NAME 
AND COM- 
PONENT NAME 

[PROJ_NAME]-> V_PROJ_COM-<- [COM_NAME] 
^ [COM_NO] 

COM STAT 

l 

[FIN AL_OR IG 1 N_C AT| 

PI 96. D181 , 
PI 98, D183, 
P200-P202, 
D1 85-01 86, 
P204-P206, 
D1 89-01 90, | 
P208, D193, 
P210, 0195, 
P212, 0197 

DSF 

MEASURE 

MEASURE 

VALUE 

PROJECT NAME 
AND MEASURE- 
MENT CODE 

[PROJ_NAME] — ► PROJECT 

| [PROJ_NO] 

PROJ_DSF 

| [°J D 1 

[MEASURE_COD.E] -> DSF_MEASURE 
[MEASURE_VALUE] 

WHERE 

MEASURE CODE FOR PI 96, D1 81 = MODDESIGN 
MEASURE CODE FOR P198, 0183 = MODCODE 
MEASURE CODE FOR P200, D185 = SYSTSTONE 
MEASURE CODE FOR P201 , D186 = SYSTSTPASS 
MEASURE CODE FOR P202 = SYSTSTRUN 

MEASURE CODE FOR P204, D189 = ACCTSTONE 
MEASURE CODE FOR P205.D 190= ACCTSTPASS 
MEASURE CODE FOR P206 = ACCTSTRUN 

MEASURE CODE FOR P208, D193 = DISCRES 
MEASURE CODE FOR P210, D195 = SPECMODIMP 
MEASURE CODE FOR P212. D19 = QUESTANS 


10004437L 


4-79 





















Table 4-4. SEL Database Access Paths (8 of 28) 



Target 

Table 

Target 

Column 

Access 

Information 

Access Path 


DSF 

TARGET 

TARGET 

VALUE 

PROJECT NAME 
AND 

TARGET^CODE 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ_DSF 
| [DJD] 

[TARGET CODE] -> DSF TARGET 

4 

[TARGET_VALUE] 

WHERE 

TARGET_CODE FOR PI 95, D180 = TOTDESIGN 
TARGET_CODE FOR PI 97, 01 82 = TOTCODE 
TARGET_CODE FOR PI 99, D1 84 = TOTSYSTST 
TARGET_CODE FOR P203, 0188 = TOTACCTST 
TARGET_CODE FOR P207, D192 = TOTDISCREP 
TARGET_CODE FOR P209, D194 = SPECMODREC 
TARGET_CODE FOR P211, D196 = QUESTSUB 

P25-P34, 

023-032, 

PI 57-PI 66. 
0199-0208 

EFF_ACT 

ACT_HR 

(FROM PRF 
OR CLPRF) 

PROJECT NAME, 
PROGRAMMER 
NAME, WEEK 
ENDING DATE, 
SUBSYSTEM 
PREFIX (OPTION- 
AL), AND ACTIV- 
ITY 

[PROJ_NAME] -> PROJECT 

[FORM_NAME] [PROJNO] 

PERSONNEL 

1 V 

(PROGJD] — ► EFF_PROJ'< — [SUB_DATE] 

/ \ PJD ' 

[P ID) / EFF_SUB-< — [SUB_PRE] 

l 1 

[ACTIVITY] -> EFF ACT« 1 [PS ID] 

[ACT_HR] 

WHERE (FOR PRF) 

ACTIVITY FOR P25, 02 = PREDES 

ACTIVITY FOR P26, 024 = CREDES 

ACTIVITY FOR P27, 025 = RDREVDES 

ACTIVITY FOR P28, D26 = WRCODE 

ACTIVITY FOR P29, D27 = RDREVCOD 

ACTIVITY FOR P30, 028 = TSTCODUN 

ACTIVITY FOR P31, 029 = DEBUG 

ACTIVITY FOR P32, 030 = INTTEST 

ACTIVITY FOR P33, 031 = ACCTEST 

ACTIVITY FOR P34, D32 = OTHER 


10004437L 


4-80 






Table 4-4. SEL Database Access Paths (9 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P25-P34, 

D23-D32, 

PI 57-PI 66, 

D199-D208 

(Cont’d) 

EFF_ACT 

ACTJHR 

(FROM PRF 
OR CLPRF) 

PROJECT NAME, 
PROGRAMMER 
NAME, WEEK 
ENDING DATE, 
SUBSYSTEM 
PREFIX (OPTION- 
AL), AND ACTIV- 
ITY 

(FOR CLPRF) 

ACTIVITY FOR PI 57, D199 = CLPREDES 
ACTIVITY FOR PI 58, D200 = CLPRETEST 
ACTIVITY FOR PI 59, D201 = CLCREDES 
ACTIVITY FOR PI 60, D202 = CLVEREVDES 
ACTIVITY FOR PI 61, D203 = CLWRCODE 
ACTIVITY FOR PI 62, D204 = CLRDREVCOD 
ACTIVITY FOR PI 63, D205 = CLINDTEST 
ACTIVITY FOR PI 64, D206 = CLRESPSFR 
ACTIVITY FOR PI 65, D20 = CLACCTEST 
ACTIVITY FOR PI 68, D208 = CLOTHER 

P157-P166, 
D1 99-D208 

EFFECT 

ACT_HR 

(FROM 
CLPRF, 
MAPPED TO 
PRF ACTIVI- 
TIES) 

CLEAN ROOM 
PROJECT NAME, 
PROGRAMMER 
NAME, AND 
WEEK ENDING 
DATE 

•CLEAN ROOM 
ACTIVITIES ARE 
CONVERTED TO 
STANDARD ACTI- 
VITIES BY USING 
V CLEAN ROOM 
ACT 

[CLEANROOM PROJ_NAME]— ► PROJECT 

[FORM NAME] / (PROJ NO] 

1 / 

PERSONNEL / 

; / 

[PROGJD] -> EFF_PROJ<— [SUB_DATE] 
| ( P - ID 1 

[ACTIVITY] -> V CLEANROOM ACT 
[ACT_HR] 

WHERE 

ACTIVITY FOR P25. D23 = PREDES 
ACTIVITY FOR P26, D24 * CREDES 
ACTIVITY FOR P27, D25 = RDREVCOD 
ACTIVITY FOR P28, D26 = WRCODE 
ACTIVITY FOR P29, D27 = RDREVDES 
ACTIVITY FOR P31, D29 = DEBUG 
ACTIVITY FOR P32, D30 = INTTEST 
ACTIVITY FOR P33, D31 = ACCTEST 
ACTIVITY FOR P34, D32 = OTHER 


10004437L 


4-81 




















Table 4-4. SEL Database Access Paths (10 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P39, P40, 
P42, P43, 
D44, D45. 
D47, 048 

EFF_ACT 

ACT_HR 
(FROM SPF) 

PROJECT NAME, 
PROGRAMMER 
NAME, AND 
WEEK ENDING 
DATE 

[PROJ_NAME] — ► PRO. 
[FORM NAME] 

1 

PERSONNEL 

^ > 

[PROGJD] -► EFF 

\ 

[ACTIVITY] EFF 

[ACT 

WHERE 

FORM NAME FOR P39, D4 
FORM NAME FOR P40, D4 
FORM NAME FOR P42, D4 
FORM NAME FOR P43, D4 
AND 

ACTIVITY FOR P39, D44, 
P40, 045, 
P42, D47, 
P43, D48 

IECT 

[PROJ_NO] 

f 

_PROJ <- [SUB_DATE] 

[P ID] = [EFFJD] 

r 

ACT 

t 

_HR] 

4 = TECHPUBS 
15 = SECRTARY 

7 = PROGMGMT 

8 = OTHSUPP 

| = SUPPORT 

1 

j 

D37, D49, 
D210 

EFF 

FORM 

FORM_NO 

PROJECT NAME 
AND FORM TYPE 

[PROJNAME] >• PROJECT 

1 [PROJ_NO] 

EFF_PROJ 

l ( P - ID 1 

[FORM TYPE] ► EFF FORM 

I 

[FORM_NO] 

WHERE 

FORM TYPE FOR D37 = PRF 
FORMJYPE FOR D49 = SPF 
FORM TYPE FOR D210 = CLPRF 

P23, 022 

EFF 

PROJ 

SUB_DATE 

PROJECT NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 

EFF PROJ 

I 

[SUB_DATE] 


10004437L 


4-82 











Table 4*4. SEL Database Access Paths (11 of 28) 


Target 
Ref. ID Table 

PI 72-PI 77, MAINT_ 

D1 55-0160 ACT_HRS 


PI 80, D1 64 MAINT_ 
CHANGE 


P184, D168 MAINT_ 
CHANGE 


PI 88, D1 72 MAINT_ 
CHANGE 


Target 

Column 

Access 

Information 

Access Path 

ACTJHR 

PROJECT NAME, 
PROGRAMMER 
NAME, WEEK 
ENDING DATE, 
AND MAINTE- 
NANCE ACTIVITY 

[PROJJMAME] -> PROJECT 

[PROJ_NO] 

[FORM NAME] 

PERSONNEL 

1 



[PROG ID] — ► MAINT 1 

i 

r 

3 ROJ [SUB_DATE] 

[MAINTJNO] 

t 



[MAINT ACT] -> MAINT ACT_HRS 
1 



▼ 

[ACTJHR] 



WHERE 

MAINT ACT FOR PI 72, D155 = ISOLATION 
MAINT ACT FOR PI 73. D1 56 = REDESIGN 
MAINT ACT FOR PI 74. D157 = IMPLEMENT 
MAINT ACT FOR PI 75, D158 = UNSYSTEST 
MAINT ACT FOR D176, D159 = ACCBENTEST 
MAINT~ACT FOR P177, D160 = OTHER 

CHJSAUSE 

MAINTENANCE 
CHANGE NUM- 
BER; SEE 01 78 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 

1" 

[CH_CAUSE]*CODED FIELD 

CH^CLASS 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT_CH_NO] > MAINT CHANGE 

l 

[CH_CLASS]*CODED FIELD 

COMP_ADD 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D1 78 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 

1' 

[COMP_ADD] 


1 0004437 L 


4-83 

























Table 4-4. SEL Database Access Paths (12 of 28) 


Ref. ID 

PI 91, D175 


PI 93, D177 


PI 92, D176 


PI 89, 0173 


P190, D174 


PI 85, 0169 


Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

MAINT 

CHANGE 

COMP ADD 
NEW 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 
[COMP_ADD_NEW] 

MAINT 

CHANGE 

COMP ADD 
REMOD 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 

r 

[COMP_ADD_REMOD] 

MAINT 

CHANGE 

COMP ADD 
REUSE 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 

4 ' 

[COMP_ADD_REUSE] 

MAINT 

CHANGE 

COMP_CH 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — > MAINT CHANGE 

r 

[COMP_CH] 

MAINT 

CHANGE 

COMP_DEL 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D1 78 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

(MAINT CH NO] — ► MAINT CHANGE 

4 ' 

[COMP_DEL] 

MAINT 

CHANGE 

EST LOC 
ADD 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — > MAINT CHANGE 

4 ' 

[EST_LOC_ADD] 


100044371 


4-84 






























Table 4-4. SEL Database Access Paths (13 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

PI 86, D170 

MAI NT 
CHANGE 

! EST LOC 
CH 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT_CH_NO] — ► MAINT_CHANGE 

lr 

[EST_LOC_CH] 

PI 87, D171 

MAI NT 
CHANGE 

EST LOC 
DEL 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT_CH_NO] — ► MAINT_CHANG E 

1 

[EST_LOC_DEL] 

0178 

MAINT 

CHANGE 

MAINT CH 
NO 

PROJECT NAME, 
PROGRAMMER 
NAME, AND SUB- 
MISSION DATE 

[PROJ_NAME] — ► PR< 
[FORM NAME] 

1 

PERSONNEL 

4 J 

[PROGJD] > MAINT_ 

> 

[MAINT, 

DJECT 

[PROJ_NO] 

r 

CHANGE 

CHJMO] 

PI 79, D163 

MAINT 

CHANGE 

MAINT CH 
TYPE 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT CH NO] — ► MAINT CHANGE 

i' 

[MAINT_CH_TYPE]*CODED FIELD 

PI 82. D166 

MAINT 

CHANGE 

MAINT COM 
CH 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D1 78 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

[MAINT_CH_NO] — > MAINT_CHANGE 

Jr 

[MAINT_COM_CH]*CODED FIELD 


10004437L 


4-85 




























Table 4-4. SEL Database Access Paths (14 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

PI 81, D165 

MAINT 

CHANGE 

MAINT ISO 
CH 

MAINTENANCE 
CHANGE NUM- 
BER; SEE D178 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR MAINTE- 
NANCE CHANGE 
NUMBER 

(MAINT CH NO]— ► MAINT CHANGE 
1' 

[MAINT_ISO_CH]*CODED FIELD 

PI 83, D167 

MAINT 

CH 

OBJECTS 

CH_OBJECT 

MAINT CHANGE 
NUMBER 

(MAINT CH NO] 

'I 

MAINT CH OBJECTS 

i 

[CH_OBJECT]*CODED FIELD] 


P168-P171, 
D1 51-D1 54 

MAINT 

CLASS 

HRS 

CLASS_HR 

PROJECT NAME, 
PROGRAMMER 
NAME, AND 
WEEK ENDING 
DATE 

[PROJ NAME] > PROJECT 

(FORM_NAME] [PROJ_NO] 

Jr 

PERSONNEL 

Jr > r 

(PROG_ID] — ► MAINTPROJ < — [SUB_DATE] 

[MAINTJD] 

[MAINT CLASS] — > MAINT CLASS HRS 

" r 

[CLASS_HR] 

WHERE 

MAINTjCLASS FOR PI 68, D151 = CORRECTION 
MAINTjCLASS FOR P169, D152 = ENHANCEMNT 
MAINT_CLASS FOR P170, D153 = ADAPTATION 
MAINT_CLASS FOR P171, D154 = OTHER 

P23, D22 

MAINT 

PROJ 

SUB_DATE 

PROJECT NAME 

[PROJ_NAME] — > PROJECT 

FORM NAME _ 

[PROJ_NO] 

* 

PERSONNEL 

Jr V 

[PROG ID] — > MAINT PROJ 

1' 

[SUB_DATE] 

Ml 

PERSON- 

NEL 

FORM_NAME 

NONE 

PERSONNEL — ► [FORM_NAME] 



DATE_ENTRY 

PROGRAMMER 

NAME 

[FORM_NAME]S PERSONNELS [DATE ENTRY] 


10004437L 


4-86 




















Table 4-4. SEL Database Access Paths (15 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P24, D21 

PERSON- 

NEL 

FORMJJAME 

(FROM COF) 

PROJECT NAME, 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] — > PROJECT 

^ [PROJ_NO] 

[SUB_PRE] — ► PROJ_SUB 

^ [SUBSYJD] 

[COM_NAME] — ► SUB_COM 

^ [COM_NO] 

COM_SOURCE 
^ [PROGJD] 

PERSONNEL 

1 

[FORMAN AM E] 

P24, D21 

PERSON- 

NEL 

FORM_NAME 
(FROM CRF) 

CHANGE NUM- 
BER; SEE P63 
FOR THE AC- 
CESS PATH THAT 
FINDS A PARTIC- 
ULAR CHANGE 
NUMBER 

[CHANGE_NO| — ► CHANGE 

4 [PROGJD] 
PERSONNEL 

i 

[FORM_NAME] 

P24, 021 

PERSON- 

NEL 

FORM_NAME | 
{FROM DSF) 

PROJECT NAME 

' 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO] 
PROJJDSF 

4 [PROGJD] 
PERSONNEL 

i 

[FORM_NAME] 

P24, D21 

PERSON- 

NEL 

FORM_NAME 
(FROM MCRF) 

PROJECT NAME 

[PROJ_NAME] — ► PROJECT 

| [PROJ_NO] 
MAINT_CHANGE 

4 [PROGJD] 
PERSONNEL 

1 

[FORM^NAME] 


100Q4437L 


4-87 























Table 4-4. SEL Database Access Paths (16 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P24, D21 

PERSON- 

NEL 

FORM_NAME 

(FROM PRF 
OR CLPRF) 

PROJECT NAME 
AND FORM TYPE 

[PROJ_NAME] — > PROJECT 

^ [PROJ_NO] 
[FORM_TYPE] — >EFF_PROJ 

^ [PROGJD] 
PERSONNEL 

1 

[FORM_NAME] 

WHERE 

FORM_TYPE = PRF OR CLPRF 

P24, D21 

PERSON- 

NEL 

FORM_NAME 
(FROM SPF) 

PROJECT NAME 
AND FORM TYPE 

[PROJ_NAME] — ► PROJECT 

[PROJ_NO] 

[FORM_TYPE] — ► EFF_PROJ 

^ [PROG_ID] 
PERSONNEL 

i 

[FORM_NAME] 

WHERE 

FORMJTYPE = SPF 
NOTE: 

FORM NAME = LIBARIAN, OTHSUPP, 

PROGMGMT, SECRTARY, 
TECHPUBS 

P24, D21 

PERSON- 

NEL 

FORM^NAME 

(FROM 

WMEF) 

PROJECT NAME 

[PROJ_NAME] — ► PROJECT 

^ [PROJ_NO| 
MAINT_PROJ 

| (PROGJD] 

PERSONNEL 

1 

[FORMJJAME] 

M2 

PERSON- 

NEL 

FULL_NAME 

PROGRAMMER 

NAME 

[FORM_NAME}> PERSONNEL [FULL_NAME] 

P3 

PROJECT 

ACTIVE 

STATUS 

PROJECT NAME 

(PROJ NAME]-* PROJECT 

i 

[ACTIVE J5TATUS]*CODED FIELD 

PI. D1 

PROJECT 

PROJ_NAME 

NONE 

PROJECT > [PROJ_NAME] 

P2, D1 S3 

PROJECT 

PROJ_TYPE 

PROJECT NAME 

[PROJ NAME]-* PROJECT 

i 

[PROJ_TYP ENCODED FIELD 


10004437L 


88 





































Table 4-4. SEL Database Access Paths (17 of 28) 



Pi 34, D38 PROJ_ 
CPU_ 
STAT 


PI 35, D94 PROJ 
CPU_ 
STAT 


PI 36, D95 


P23, D22 PROJ_ 
DSF 


P21.D12 PROJ_ 
EST 


P20, Dll PROJ 
EST ~ 


P22, D13 PROJ 
EST 


Target 

Column 


CPU NAME 


TOTAL HRS 



SUB DATE 



Access 

Information 

Access Path 

PROJECT NAME 

[PROJ_NAME]-* PROJECT 

^ [PROJ_NO] 

PROJ CPU STAT 

i 

[CPU_NAME] 

PROJECT NAME 

[PROJ_NAME]-> PROJECT 

^ [PROJ_NO] 

PROJ CPU STAT 

1 ' 

[TOTAL_HRS] 

PROJECT NAME 

[PROJ_NAME]-> PROJECT 

^ [PROJ_NO] 

PROJ CPU STAT 

\ 

[T_ RUN] 

PROJECT NAME 

[PROJ_NAME]-> PROJECT 

^ [PROJ_NO] 

PROJ DSF 

i 

[SUB_DATE] 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME]-> PROJECT 

^ [PROJ_NO] 

[SUB DATE] -► PROJ EST 
[MAN_HR] 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME]-> PROJECT 

1 [PROJ_NO] 

[SUB DATE] -► PROJ EST 
[PRO_HR] 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME]-* PROJECT 

^ (PROJ_NO] 

[SUB DATE] -► PROJ EST 

1 

[SER_HR] 


10004437L 


4-89 
































Table 44. SEL Database Access Paths (18 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P13, D2 

PROJ 
EST ~ 

SUB_DATE 

PROJECT NAME 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

PROJ EST 

i 

]SUB_DATE] 

PI 5, D15 

PROJ 

EST 

T_COM 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE]-* PROJ EST 

1 ' 

[T_COM] 

PI 6, 016 

PROJ 

EST 

TJJNE 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE]-* PROJ EST 

1 ' 

[T_LINE] 

PI 8. D18 

PROJ 

EST 

T_MODJ_INE 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE] -* PROJ EST 

1 ' 

[T_MOD_UNE] 

PI 9, D17 

PROJ 

EST 

T_NEW_LINE 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE] -* PROJ EST 

i 


[T.NEWJJNE] 


Pi 7, D19 


PROJ 
EST " 


T OLD LINE 


PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 


[PROJ_NAME] * 


[SUBJDATE] 


PROJECT 

^ [PROJ_NO] 

PROJ EST 


1 


[T_OLDjJNE] 


Pi 4, D14 


PROJ_ 

EST 


T SYS 


PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
DESIRED SET OF 
ESTIMATES 


[PROJJNIAME] - 


[SUB_DATE] 


PROJECT 

^ [PROJ_NO] 

PROJ_EST 

|T_SYS] 
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Table 4-4. SEL Database Access Paths (19 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P10, 091 

PROJ 

EST 

PHASE 

END_DATE 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
PEF OR PCSF 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE]-* PROJ EST PHASE 

1 

MAX [ENDJDATE] 

P6-P11. 

D3-08, 

P125-P131, 

D84-D90 

PROJ 

EST 

PHASE 

START_DATE 

PROJECT NAME 
AND SUBMIS- 
SION DATE OF 
PEF OR PCSF 

[PROJ_NAME] -* PROJECT 

| [PROJ_NO] 

[SUB DATE] -* PROJ EST PHASE 

i 

MIN [START_DATE] 

P6-P11, 

PROJ 

EST 

PHASE 

START DATE, 
ENDJDATE 

PROJECT NAME, 
PHASE CODE, 
AND SUBMIS- 
SION DATE OF 
PEF OR PCSF 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE]-* PROJ EST PHASER [PHASE 
| CO, 

[START DATE], 

[END_DATE] 

WHERE 

PHASE CO FOR P6, D3, PI 25, D84 = REQNT 
PHASE CO FOR P7, D4, PI 26. D85 = DESGN 
PHASE CO FOR P8, D5, PI 27, D86 = CODET 
PHASE CO FOR P9, D6, PI 28, D87 = SYSTE 
PHASE CO FOR P10, D7, P129, 088 = ACCTE 
PHASE CO FOR P11 , D8, P130, D89 = CLEAN 
PHASE_CO FOR PI 31 , D90 = MAINT 

P5. P13, 
PI 24, 02 

PROJ 

EST 

PHASE 

SUB_DATE 

PROJECT NAME 

' 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

PROJ EST PHASE 

i 

[SUB_DATE] 

D20, D49, 
D113, D150 

PROJ 

FORM 

FORM_NO 

PROJECT NAME, 
AND FORM TYPE 

[PROJ_NAME] -* PROJECT 

1 [PROJ_NO] 

[FORM TYPE]-* PROJ FORM 

1 

[FORM_NO] 

WHERE 

FORM TYPE FOR D150 = SEF 
FORM TYPE FOR D20 = PEF 
FORM TYPE FOR D49 = SPF 
FORM TYPE FOR Dll 3 = PCSF 
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Table 4-4. SEL Database Access Paths (20 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P62, D42 

PROJ 

GRH 

GR_CH 

PROJECT NAME, 
AND WEEK END- 
ING DATE 

[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB DATE] -> PROJ GRH 

1 

[GR_CH] 

P60, 043 

PROJ 

GRH 

GR_LINE 

PROJECT NAME 
AND WEEK END- 
ING DATE 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[SUB DATE] -> PROJ GRH 
[GR_LINE] 

P61, D41 

PROJ 

GRH 

GR_MOD 

PROJECT NAME 
AND WEEK END- 
ING DATE 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[SUB DATE] -* PROJ GRH 
1 ' 

[GR_MOD] 

P4, D62 

PROJ 

MES- 

SAGES 

MESSAGES 

PROJECT NAME 
AND NOTE TYPE 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[NOTE_TYPE] -> PROJ_NOTES 

| [S -' D! 

PROJ MESSAGES 

1 ' 

[MESSAGES] 

WHERE 

NOTE_TYPE = CLOSEOUT, COMPACCTS, 
COMPSYS, CONTACTS, 
CONTRLLIB, DATAAVAIL, 
FORMSCOL, GENMESS. GHTOOL, 
LANGUAGES, PROJNAME, OR 
TASKNO 

P4, D61 

PROJ 

NOTES 

NOTE_TYPE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

1 [PROJ_NO] 

PROJ NOTES 

1 

(NOTE_TYPE]*CODED FIELD 
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Table 4-4. SEL Database Access Paths (21 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P45, D39 

PROJ 

PROD 

RES_HR 

PROJECT NAME 
COMPUTER 
NAME, AND 
WEEK ENDING 
DATE 

[PROJ_NAME] -► PROJECT 

1 [PROJ_NO] 

[SUB DATE] -> PROJ PROD <r [RES NAME] 

i 

[RESJHR] 

P44, D38 

PROJ 

PROD 

RES_NAME 

PROJECT NAME 

; 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ PROD 

1 " 

[RES_NAME] 

P46, D40 

PROJ 

PROD 

RES_RUN 

PROJECT NAME, 
COMPUTER 
NAME, AND 
WEEK ENDING 
DATE 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[SUB DATE] -► PROJ PROD <- [RES NAME] 

i 

[RES_RUN] 
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Table 4-4. SEL Database Access Paths (22 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

information 

Access Path 

P88-P107, 
D114-D133, 
PI 09-PI 23, 
D135-D149 

PROJ 

SEF 

EVALUATE 

PROJECT NAME 
AND MEASURE- 
MENT TYPE 

[PROJ_NAME| -* PROJECT 

^ [PROJ_NO] 

[MEAS TYPE] -> PROJ SEF 

1' 

[EVALUATE] 

WHERE 

MEAS_TYPE FOR P88, Dll 4 = PM01 
MEAS_TYPE FOR P89, 0115 = PM02 
MEAS_TYPE FOR P90, 0116 = PM03 
MEAS_TYPE FOR P91, Dll 7 = PM04 
MEAS_TYPE FOR P92, 0118 = PM05 
MEAS_TYPE FOR P93, Dll 9 = PM06 
MEAS TYPE FOR P94, D120 = ST07 
MEAS_TYPE FOR P95, D121 = ST08 
MEAS TYPE FOR P96, 0122 = ST09 
MEAS_TYPE FOR P97, 0123 = ST10 
MEAS_TYPE FOR P98, D124 = TM11 
MEAS_TYPE FOR P99, D125 = TM12 
MEAS_TYPE FOR P100, D126 = TM13 
MEAS_TYPE FOR PI 01, 0127 = TM14 
MEAS_TYPE FOR PI 02, 0128 = TM15 
MEAS_TYPE FOR PI 03, D1 29 = PC 16 
MEAS_TYPE FOR PI 04, D130 = PCI 7 
MEAS_TYPE FOR P105, D131 = PC18 
MEAS_TYPE FOR P106, D132 = PC19 
MEAS_TYPE FOR P107, D133 = PC20 
MEAS_TYPE FOR P109, 0135 = PC22 
MEAS_TYPE FOR P110, D136 = PC23 
MEAS_TYPE FOR Pill, 0137 = PC24 
MEAS_TYPE FOR P1 12, D138 = EN25 
MEAS_TYPE FOR P113, D139 = EN26 
MEAS_TYPE FOR P1 14, 0140 = EN27 
MEAS_TYPE FOR P115, 0141 = EN28 
MEAS TYPE FOR P1 16, 0142 = EN29 
MEAS_TYPE FOR P117, D143 = EN30 
MEAS_TYPE FOR P118, D144 = PT31 
MEAS_TYPE FOR P119, D145 = PT32 
MEAS_TYPE FOR P120, 0146 = PT33 
MEAS_TYPE FOR P121, 0147 = PT34 
MEAS_TYPE FOR P122, 0148 = PT35 
MEAS_TYPE FOR PI 23, 0149 = PT36 

PI 08, D134 

PROJ 

SEF_SEC 

SECOND_L 

PROJECT NAME 
AND MEASURE- 
MENT TYPE 

[PROJ_NAME] -* PROJECT 

1 [PROJ_NO] 

[MEAS TYPE] -> PROJ SEF SEC 
1' ' 

[SECOND_L]*CODED FIELD 
NOTE: MEAS TYPE = PC21 
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Table 4-4. SEL Database Access Paths (23 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

P133, D93 

PROJ 

SER HR 

STAT 


PI 32, D92 

PROJ 

TECH MAN 


STAT 

HR 

PI 39, 098 

PROJ 

T CH 

STAT 


PI 38, D97 

PROJ 

T COM 

STAT 


Pi 45, D104 

PROJ 

T_COMMENT 

STAT 


PI 40, 099 

PROJ 

T_DOC 

STAT 

1 

PI 46, 0105 

PROJ 

T_EXE_MOD 

STAT 



Access 

Information 


PROJECT NAME 

[PROJ_NAME] -> 

PROJECT NAME 

[PROJ_NAME] -> 

PROJECT NAME 

[PROJ_NAME] -> 

PROJECT NAME 

[PROJ_NAME] -► 

PROJECT NAME 

; 

; 

[PROJ_NAME] -> 

PROJECT NAME 

[PROJ_NAME] -► 

PROJECT NAME 

[PROJJMAME] 


Access Path 


PROJECT 


1 


[PROJ_NO] 
PROJ STAT 


4 


[SER_HR] 


PROJECT 

^ [PROJ_NO] 

PROJ STAT 


l 


[T EC H_MA N_H R] 


PROJECT 

^ [PROJ_NO] 

PROJ STAT 


4 


[T_CH] 


PROJECT 


4 


[PROJ_NO] 
PROJ STAT 


4 


[T_COM] 


PROJECT 

^ [PROJ_NO] 

PROJ STAT 


4 


[T_COMMENT] 


PROJECT 


4 


(PROJ_NO] 
PROJ STAT 


4 


fr_DOC] 


PROJECT 


4 


[PROJ_NO] 
PROJ STAT 


4 


[T_EXE_MOD] 
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Table 4-4. SEL Database Access Paths (24 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

PI 50, D109 

PROJ 

STAT 

T_EXE_STAT 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

l 

[TJEXE_$TAT] 

P213. D211 

PROJ 

STAT 

T EXTMO 
LINE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJJMO] 

PROJ STAT 

i' 

[T_EXTMOJJNE] 

P214, 0212 

PROJ 

STAT 

T EXTMO 
MOD 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJJMO] 

PROJ STAT 

T 

[T_EXTMO_MOD] 

P215, D213 

PROJ 

STAT 

T EXTMO 
STAT 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 " 

[T_EXTMO_STAT] 

P219, D217 

PROJ 

STAT* 

T EXTMO 
STMTS 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 

[T_EXTMO_STMTS] 

Pi 41, 0100 

PROJ 

STAT 

T_LINE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 
(TJJNE] 

Pi 43, D102 

PROJ 

STAT 

T_MOD_LINE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

1 [PROJ_NO] 

PROJ STAT 

1 

[T_MOD_LINE] 
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Table 4-4. SEL Database Access Paths (25 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

PI 48, D107 

PROJ 

STAT 

T_MOD_MOD 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 
[T_MOD_MOD] 

PI 52, Dill 

PROJ 

STAT 

T_MOD_STAT 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 ' 

[T_MOD_STAT] 

P218, D216 

PROJ 

STAT 

T MOD 
STMTS 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

i 

[T_MOD_STMTS] 

PI 42, D101 

PROJ 

STAT 

T_NEW_LINE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

i 

(T_NEW_UNE] 

Pi 47, D106 

PROJ 

STAT 

T_NEW_MOD 

PROJECT NAME 

! 

[PROJ_NAME] ■> PROJECT 

^ [PROJ_NO] 

PROJ STAT 
1 ' 

[T_NEW_MOD] 

P151 , D110 

PROJ 

STAT 

T_NEW_STAT 

PROJECT NAME 

[PROJ_NAME] -* PROJECT 

1 [PROJ_NO] 

PROJ STAT 

1 

[T_NEW_STAT] 

P217, D21 5 

PROJ 

STAT 

T NEW 
STMTS 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

1 [PROJ_NO] 

PROJ STAT 
[T_NEW_STMTS] 
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Table 4*4. SEL Database Access Paths (26 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

PI 44, D103 

PROJ 

STAT 

T_OLD_LINE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

i 

[T_OLD_UNE] 

PI 49, 0108 

PROJ 

STAT 

T_OLD_MOD 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 " 

U_OLD_MOD] 

PI 53, D112 

PROJ 

STAT 

T_OLD_STAT 

PROJECT NAME 

i 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 " 

[T_OLD_$TAT] 

P220, D218 

PROJ 

STAT 

T OLD 
; STMTS 

PROJECT NAME 

[PROJ_NAME] -► PROJECT 

^ [PROJ_NO] 

PROJ STAT 

1 ' 

[T_OLD_STMTS] 

P216, D214 

PROJ 

STAT 

T_STMTS 

PROJECT NAME 

[PROJ_NAME] -► PROJECT 

^ [PROJ_NO] 

PROJ STAT 

l' 


[T_STMTS] 


P137, D96 

PROJ 

STAT 

T_SYS 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

1 [PROJ_NO] 

PROJ STAT 

1 

U_SYS] 

P47, P84, 
D50 

PROJ 

SUB 

SUB_PRE 

PROJECT NAME 

[PROJ_NAME] -> PROJECT 

1 [PROJ_NO| 

PROJ SUB 

i 

[SUB_PRE] 
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Table 4-4. SEL Database Access Paths (27 of 28) 


Ref. ID 


Target 

Table 



Target 

Column 


SUB DATE 


P35-P38, SPECIAL, ACT_HR 
D33-D36, ACT 
PI 67, D209 


Access 

Information 


PROJECT NAME 
AND SUBSYS- 
TEM PREFIX 


PROJECT NAME 
PROGRAMMER 
NAME, WEEK 
ENDING DATE, 
AND SPECIAL 
ACTIVITY 


P49 D52 SUBSYS- FUNCTION PROJECT NAME 
TEM AND SUBSYS- 

TEM PREFIX 


Access Path 


[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[SUB PRE] -* PROJ_SUB 

1 

[SUB_DATE] 


[PROJ_NAME] -► PROJECT 
[FORM_NAME] [PROJ_NO] 

PERSONNEL 

i i 

[PROGJD]— > EFF_PROJ<— [SUB_DATE] 

| [PJD] = [EFF I D] 

[ACTIVITY] — * SPECIAL_ACT 

i 

[ACT_HRJ 

WHERE (FOR PRF) 

SP_ACTIVITY FOR P35, D33= REWORK 
SP_ACTIVITY FOR P36, D34= ENHANCE 
SP_ACTIVITY FOR P37, D35= DOCUMENT 
SP_ACTIVITY FOR P38, D36= REUSE 

(FOR CLPRF) 

SP_ACTIVITY FOR PI 67, D209 = CLMETHOD 


[PROJ_NAME] -* PROJECT 

^ [PROJ_NO] 

[SUB_PRE] -► PROJ_SUB 

^ [SUBSY_ID] 


SUBSYSTEM 



SUBSYS- NAME 
TEM 


PROJECT NAME 
AND SUBSYS- 
TEM PREFIX 


[FUNCTION]*CODED FIELD 


[PROJ_NAME] -> PROJECT 

I [PROJ_NO| 

[SUB_PRE] -> PROJ_SUB 

I [SUBSYJD] 

SUBSYSTEM 

1 

[NAME] 
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Table 4-4. SEL Database Access Paths (28 of 28) 


Ref. ID 

Target 

Table 

Target 

Column 

Access 

Information 

Access Path 

P51 , DS3 

SUB^COM 

COM_NAME 

PROJECT NAME 
AND SUBSYS- 
TEM PREFIX 

[PROJ_NAME] -> PROJECT 

^ [PROJ_NO] 

[SUB_PRE] -> PROJ_SUB 

^ [SUBSYJD] 

SUB COM 

i 

[COM_NAME] 

P52, 02 

SUB_COM 

COM_DATE 

PROJECT NAME 
SUBSYSTEM 
PREFIX, AND 
COMPONENT 
NAME 

[PROJ_NAME] -»• PROJECT 

^ (PROJ_NO] 

[SUB_PRE] PROJ_SUB 

^ [SUBSY_ID] 

[COM NAME] SUB COM 

i 

[COM_DATE] 

P84, D53 

V PROJ 
COM 

COM_NAME 

PROJECT NAME 

CHANGE_COM 
^ [COM_NO] 

[PROJ NAME] -> V PROJ COM 

'1 ' 
[COM_NAME] 
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SECTION 5— ACCESSING THE SEL DATABASE 


The database table definitions, relationships, and access paths presented in Section 4 provide 
a guide to finding a particular software engineering data item in the database. This section 
discusses how to actually access a data item once its location in the schema has been 
identified. 

Section 5.1 discusses how a user initially obtains access to the SEL database. Section 5.2 
provides an introduction to the DAMSEL user interface (UI) subsystem: menus that allow 
users to view data, enter data, generate reports, and perform various database support 
functions. Section 5.3 presents an introduction to ad hoc database queries via SQL*Plus, 
which is provided by ORACLE. This introduction covers the basics of how to formulate a 
SQL query and provides several illustrative examples. Section 5.4 presents an introduction 
to the query library. This introduction covers the help system, searching the library, and 
executing and spooling queries. 

5.1 DATABASE ACCESS REQUIREMENTS 

To access the SEL database through SQL*Plus, a user must have a user ID and password for 
the STL VAX 1 1/780 and an ORACLE user ID and password on the VAX. To access the SEL 
database through DAMSEL, a user must have these IDs and passwords, plus have their 
ORACLE user ID enrolled as a DAMSEL user. All of these can be obtained by contacting 
either STL systems personnel or the SEL DBA at CSC. In DAMSEL, user classes are defined 
to give diff erent types of users appropriate levels of database access. The user class deter- 
mines the access privileges a user has with respect to individual database tables and the 
functions that may be performed in DAMSEL. The following user classes have been 
defined: 

• General user — Users requiring read-only access to the database, such as research- 
ers and managers 

• Librarian — SEL data entry personnel 

• QA — SEL quality assurance personnel 

• Maintenance — SEL database maintenance programmers 

• DBA — SEL database administrator 

Once a user obtains the appropriate accounts and privileges and logs onto the STL VAX, the 
user must execute the following command procedure to create all of the logicals and symbols 
required to access the ORACLE RDBMS and the DAMSEL system: 

$ @STL DISKl:[TOOLS]SELINIT 
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To avoid having to type this command each time the user logs on the VAX to access the 
database, it is recommended that the command be included in the user’s LOGIN.COM file. 
Then it will be executed automatically whenever the user logs onto the VAX. 

5.2 DAMSEL 

DAMSEL provides a convenient way for all classes of users to access the SEL data. This 
menu-driven user interface has five major options at the top level: 

• F orm function option — This option permits users to view, insert , update , delete , 
or quality assure SEL data interactively, one SEL form at a time. The screens for 
performing these operations display data in a manner that resembles the data 
collection forms presented in Section 3. 

• Report function option — This selection provides a method for users to view 
large amounts of data on single projects, or on multiple projects, within a single 
report. Reports are available for viewing data that are not project-specific or re- 
lated to SEL forms. Users select a sequence of reports and options (a script) from 
the report menus and submit the script to be executed. They may also save ffe- 
quendy used report scripts for future execution. Reports can be submitted interac- 
tively or as batch jobs. The results may be printed or routed to files for terminal 
display and/or future printing. 

• Query support function option — This selection provides a set of ad hoc SQL 
queries that would likely be used by general users, such as researchers and manag- 
ers. (This option is currendy not available.) 

• DBA function option — This selection provides data entry screens for the SEL 
DBA to enter or modify projects, personnel information, and computer informa- 
tion and to perform various database verification tasks. 

• General database support function option — This selection provides to SEL 
database support personnel the capability to generate distribution tapes. 

Users, depending on their assigned user class, may have access to one or more of these 
functions. The menu system has built-in security features to verify that each user has the 
access privilege to the functions that he or she is attempting to perform. The message “You do 
not have access to this option” will appear on the screen if the user tries to perform a function 
that is not in his/her operational domain. Each user class has different access privileges in the 
menu system. These are defined as follows: 

• General user — This class of user can access all the SEL form function viewing 
screens, all the report function screens, and all the query support function screens. 

• Librarian — This class of user can access all the SEL form function viewing, in- 
sert, update, and delete screens; all the report function screens; and the general 
database support function screens. 
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• QA — This class of user can access all the SEL form function viewing and quality 
assurance screens, plus all the report function screens. 

• Maintenance — This class of user can access all the SEL form function viewing 
screens, all the report function screens, all the query support function screens, and 
the general support function screens. 

• DBA — This class of user can access all the SEL form function viewing screens, 
all the report function screens, all the query support function screens, all the DBA 
function screens, and all the general support function screens. 

After the database access requirements, described in Section 5.1, are satisfied, the user can 
access DAMSEL as follows: 

• Log on to the VAX using his/her VAX user ID and password. 

• At the ‘$’ prompt, type DAMSEL. 

• Enter his/her ORACLE user ID and password at the prompts on the DAMSEL 
login screen. 

• Select menu options. 

• Terminate the DAMSEL session via the <Exit/Cancel> key. 

Reference 3 presents a more detailed discussion on using the DAMSEL software. 

5.3 AD HOC DATABASE QUERIES 

The basic operations that may be performed on a database table are retrieving rows and 
columns, inserting rows, deleting rows, and updating existing rows. In the SEL database, 
insertion, deletion, and update operations are all performed via DAMSEL, as described in 
the previous section. This is done to ensure that the semantic constraints imposed by the 
nature of the software engineering data, as discussed in Section 4.2, are enforced at all times. 
The operation of retrieving data, however, may be done in any context without risk of 
violating the integrity of the database. This section discusses how to perform database 
retrievals in an ad hoc manner. Additional examples of optimized SQL queries are presented 
in Appendix B. Although an introduction to the SQL SELECT statement is included, the 
coverage is not exhaustive. Refer to Reference 4 for a more in-depth presentation of the SQL 
language. 

5.3.1 Connecting to the Database 

Once a user with database access (Section 5.1) has logged onto the VAX, typing the follow- 
ing command at the system prompt connects him/her to the SEL database: 

$ SQLPLUS 
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After supplying an ORACLE user ID and password at the prompts, the user is placed in an 
interpretive environment from which he/she may enter ad hoc SQL queries to retrieve 
database data. The command line prompt 

SQL> 

is displayed, signaling that the system is waiting for a SQL command. Upon entering a SQL 
command, terminated with a semicolon (;), and pressing the return key, SQL processes the 
command, displays the result, and returns to the SQL> prompt. 

While in a SQL*Plus session, the following online HELP command is available: 

SQL> HELP; 

This displays a list of SQL commands, clauses, and related topics for which help is available . 
To exit from a SQL*Plus session, the user types 
SQL> EXIT 

which will disconnect the user from ORACLE and return to the system prompt ($). 

5.3.2 Basic Select Statement 

The SQL statement for retrieving data from the database is the SELECT statement. In its 
simplest form, the SELECT statement has the following syntax: 

SQL> SELECT * FROM <table-name>; 

This statement displays on the terminal screen every row in the table indicated, as in the 
following example: 

SQL> SELECT * FROM PROJECT; 


PROJ_NAME 

PROJ_NO 

PROJ_TYPE 

ACTIVESTATUS 

PROJ_101 

101 

SIMULATOR 

ACT_DEV 

PROJ_102 

102 

AGSS 

ACT_DEV 

PROJ_103 

103 

SIMULATOR 

ACTJDEV 

PROJ_104 

104 

SIMULATOR 

ACT_DEV 

PROJ_105 

105 

AGSS 

ACT_DEV 

PROJ_106 

106 

SIMULATOR 

ACTJDEV 

PROJJ71 

71 

SIMULATOR 

INACTIVE 

PROJJIO 

110 

AGSS 

ACT_DEV 

PROJ_108 

108 

SIMULATOR 

ACT_DEV 

PROJ_96 

96 

ORBIT 

INACTIVE 

PROJ_73 

73 

ATTITUDE 

ACT_MAINT 

PROJ_72 

72 

OTHER 

ACT_DEV 
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The **’ in this form of the SELECT statement indicates that all columns of the table should 
be retrieved. To retrieve only specific columns, the should be replaced by a list of the 
desired column names. The column names need not be specified in the order in which they 
are defined in the table definition, as illustrated in the following example: 

SQL> SELECT PROJ_NO, PROJ_NAME FROM PROJECT; 

PROJ_NO PROJ_NAME 

108 PROJ_108 

96 PROJ_96 

73 PROJ_73 


5.3.3 Ordering the Retrieved Data 

The SELECT statements seen thus far do not guarantee that the rows retrieved from the table 
will be displayed in any particular order. This may be ensured by specifying an ORDER BY 
clause on the SELECT statement, as in the following: 

SQL> SELECT PROJ_NAME, PROJ_NO 

2 FROM PROJECT 

3 ORDER BY PROJ_NAME; 

PROJ_NAME PROJ_NO 


PROJ_73 73 

PROJ_101 101 

PROJ_102 102 

PROJ 110 110 


This causes the retrieved rows to be displayed in ascending order, sorted on the column 
specified in the ORDER BY clause. CHARACTER columns are sorted alphabetically, 
NUMBER columns are sorted numerically, and DATE columns are sorted chronologically. 
The default order in an ORDER BY clause is ascending. A display in descending order may 
be accomplished by specifying DESC after the name of the ORDER BY column. The 
ORDER BY clause also permits sorting on more than one field. 

In the previous example, the SELECT statement was entered on more than one line. This 
illustrates that the SQL interpreter does not execute the command until a semicolon is 
entered. The typed command is stored in a buffer that is retained after the command is 
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executed. This buffer may be edited to change the query slightly without having to retype it 
completely. The current command in the buffer may be executed by typing 

SQL> / 

followed by a carriage return. The command buffer may be displayed by typing ‘L’ , followed 
by a carriage return: 

SQL>L 

1 SELECT PROJ_NAME, PROJ.NO 

2 FROM PROJECT 

3 ORDER BY PROJ_NAME 

Reference 4 provides details on editing the command buffer. 

5.3.4 Limiting the Number of Rows Retrieved 

The queries presented thus far have all displayed every row of the table specified. The 
WHERE clause allows constraints to be defined that limit the number of rows retrieved, as in 
the following example: 

SQL> SELECT * FROM PROJECT WHERE PROJ TYPE = ‘SIMULATOR’; 


PROJ_NAME 

PROJ_NO 

PROJ_TYPE 

ACTIVEJSTATUS 

PROJ_101 

101 

SIMULATOR 

ACT_DEV 

PROJJ71 

71 

SIMULATOR 

INACTIVE 

PROJ_108 

108 

SIMULATOR 

ACT_DEV 

PROJ_103 

103 

SIMULATOR 

ACTJDEV 

PROJ_104 

104 

SIMULATOR 

ACT_DEV 

PROJ_106 

106 

SIMULATOR 

ACT_DEV 


This query selects only those records in which the PROJ TYPE column has a value of 
‘SIMULATOR’. It should be noted that, when specifying a character constant (or a date 
constant), it must be surrounded by single quotes. Date constants must be specified as 
follows: ‘dd-mmm-yy ’ , as in ‘05-J AN-88 ’ . ORACLE character fields are case sensitive, and 
all the character fields in the SEL database that are commonly used in queries contain only 
uppercase characters. 

Additional relational operators useful in specifying WHERE conditions include the 
following: 

!= not equal to 

> greater than 

>= greater than or equal to 

< less than 

<= less than or equal to 

IN member of a list of items 
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The following example illustrates the use of the IN operator: 


SQL> SELECT * FROM PROJECT 

2 WHERE PROJ.NO IN (101,103,105,107); 


PROJ_NAME 

PROJ_105 
PROJ_103 
PROJ 101 


PROJ_NO 

105 

103 

101 


PROJ_TYPE 

AG SS 

SIMULATOR 

SIMULATOR 


ACTIVE_STATUS 
ACT_DEV 
ACT_DEY 
ACT DEV 


Conditions in a WHERE clause may be combined by the logical connectives AND, OR. and 
NOT to build more complex conditions, as follows: 

SQL> SELECT * FROM PROJECT 

2 WHERE PROJ_TYPE = ‘SIMULATOR’ 

3 AND PROJ_NO > 104: 

PROJNAME PROJ_NO PROJ_TYPE ACTIVE_STATUS 

PROJ_106 106 SIMULATOR ACT_DEV 

PROJ_108 108 SIMULATOR ACT_DEV 


When multiple conditions are specified, parentheses ( ) may be used to clarify or override 
precedence of operators. 


5.3.5 Group Functions 

A set of functions in SQL*Plus allows statistics to be calculated on the results of a query. 
Some of the most common of these are COUNT, AVG, MAX, MIN, SUM, STDDEV, and 
VARIANCE. The following example illustrates how these work: 

SQL> SELECT COUNT(PROJ_NO) 

2 FROM PROJECT; 


COUNT(PROJ_NO) 

90 

This query returns a count of the number of rows in the PROJECT table that have a non-null 
value in the PROJ_NO column. Null values are entered into a particular column of a 
particular row to indicate that no data exist for that data item. The table definitions in 
Section 4.1 indicate which columns in the database will accept null values. Thus, in the case 
of the above query, since the PROJ_NO column does not accept null values, the query always 
returns a count of all rows in the table. Like COUNT, the statistical functions AVG. 
STDDEV, and VARIANCE operate only on non-null values. Another example is as tollows: 

SQL> SELECT COUNT(RES_HR), SUM(RES_HR), AVG(RES_HR) 

2 FROM PROJ_PROD 

3 WHERE PROJ_NO =151; 
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COUNT(RES_HR) SUM(RES_HR) AVG(RES_HR) 

22 1.88 .085454545 

5.3.6 Retrieving from More Than One Table — Joins 

At this point, enough of the basic features of the SELECT statement have been presented to 
allow the user to find a particular piece of data in the database. Suppose, for example, the user 
wishes to know the names of the subsystem prefixes for project EXAMPLE. Consulting 
Section 4.3, the first step is to find the PROJ_NO value for that project: 

SQL> SELECT PROJ_NO 

2 FROM PROJECT 

3 WHERE PROJ_NAME = ‘EXAMPLE’; 

PROJ_NO 

135 

The user can use this result to retrieve the subsystem prefixes from PROJ_SUB: 

SQL> SELECT SUB_PRE 

2 FROM PROJ_SUB 

3 WHERE PROJ_NO = 135; 

SUBPRE 

PP 

SD 

TM 

PG 

CM 

UT 

AC 

This works, but rather than doing this in two steps every time, the same result can be 
accomplished by a single query that joins the two tables: 

SQL> SELECT SUB_PRE 

2 FROM PROJECT, PROJ_SUB 

3 WHERE PROJ_NAME = ‘EXAMPLE’ 

4 AND PROJECT.PROJ_NO = PROJ_SUB.PROJ_NO; 

SUBPRE 

PP 

SD 

TM 

PG 

CM 

UT 

AC 


1 000443 7L 


5-8 



In this query, ORACLE created a virtual table containing all the columns in both the 
PROJECT and PROJ_SUB tables. If no constraints had been specified, the virtual table 
would have contained a row for each possible pairing of a row in PROJECT with a row in 
PROJ_SUB. However, the WHERE clause allowed it to create a virtual table in which the 
only row selected from the PROJECT table was that in which the PROJ_NAME was 
EXAMPLE; the only rows selected from the PROJ_SUB table were those in which the 
PROJ_NO column had the same value as the PROJ_NO column in the row selected from 
PROJECT (the PROJ_NO value for EXAMPLE). A join is not limited to two tables, and the 
columns displayed may come from any of the tables specified, as in the following example 
that displays the same subsystems as above, but includes the name of the project and the 
descriptive name of the subsystem: 

SQL> SELECT PROJ_NAME, SUB_PRE, NAME 

2 FROM PROJECT, PROJ_SUB, SUBSYSTEM 

3 WHERE PROJ_NAME = ‘EXAMPLE’ 

4 AND PROJECT.PROJ_NO = PROJ_SUB.PROJ_NO 

5 AND PROJ_SUB.SUBSY_ID = SUBSYSTEM.SUBSYJD 

6 ORDER BY SUB_PRE; 

PROJ_NAME SUBPRE 
EXAMPLE AC 

EXAMPLE CM 

EXAMPLE PG 


NAME 

ATTITUDE AND ORBIT CONTROL 
COMMON BLOCKS 
PLOT GENERATOR 


When the same column name occurs in more than one of the tables selected, that name must 
be qualified with the table name to refer to it within the query. Thus, PROJ_N O is qualified to 
differentiate between its occurrences in the PROJECT and PROJ_SUB tables, but 
PROJ_NAME need not be qualified, since it occurs only in the PROJECT table. 

5.3.7 Retrieving from More Than One Table — Subqueries 

Suppose the user wants to know the most recendy estimated start and end dates for the design 
phase of project EXAMPLE. The user could join PROJECT and PROJ_EST_PHASE on the 
PROJ_NO field and get all of the estimated design phase start and end dates for that project. 
To limit the retrieval to only one pair of dates, however, a subquery is used. The most 
common use of a subquery is in specifying conditions on a WHERE clause, as follows: 

SQL> SELECT PROJ_NAME, PHASE_CO, START_DATE, END_DATE 

2 FROM PROJECT, PROJ_EST_PHASE 

3 WHERE PRO J_NAME = ‘EXAMPLE’ 

4 AND PHASE_CO = ‘DESGN’ 

5 AND PROJECT.PROJ_NO = PROJ_EST PHASE.PROJ_NO 
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4 6 AND 

7 

8 
9 


SUB_DATE = 

(SELECT MAX(SUB_DATE) 

FROM PROJ_EST_PHASE 

WHERE PROJ_EST_PHASE.PROJ_NO = PROJECTPROJ_NO); 


PROJ_NAME PHASE_CO STARTDATE END DATE 

EXAMPLE DESGN 06-JUN-87 02-JAN-88 


This query joins the PROJECT and PROJ_EST_PHASE tables on the PROJ_NO field, and 
further limits the retrieval by specifying that only the PROJ_EST_PHASE row with the most 
recent SUB_DATE for the specified project be selected. Note that subqueries are enclosed in 
parentheses, and they must return a single value or a single column of values. The relational 
operator IN may be used to see if a value is in a column of values returned by a subquery. 
Also, subqueries may be nested, as in the following example that lists the names of all 
components under project EXAMPLE: 


COM_NAME 
SUB_COM 
SUBSYID IN 
(SELECT SUBSY_ID 
FROM PROJ_SUB 
WHERE PROJ_NO = 

(SELECT PROJ_NO 
FROM PROJECT 

WHERE PROJ_NAME = ‘EXAMPLE’)); 

COMNAME 

PROID 

PROINI 

PROINT 

ACQINT 

DELP 

GETCAS 


SQL> SELECT 

2 FROM 

3 WHERE 

4 

5 

6 

7 

8 
9 


5.3.8 Views — A Shortcut for Commonly Used Joins 


Several views have been defined in the SEL database to allow users quick access to common- 
ly used data items. A view is a virtual table that consists of columns from one or more tables 
selected by criteria specified in the definition of the view. For example, to be able to retrieve 
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all the component names for a given project, the V_PROJ_COM view was defined (refer to 
the table and view definitions in Section 4.1). Thus, the following: 

SQL> SELECT * FROM V_PROJ_COM 

WHERE PROJ_NAME = <project name>; 

is equivalent to 

SQL> SELECT PROJ_NAME, SUB_PRE, COM_NAME, COM_NO 
FROM PROJECT, PROJ_SUB, SUB_COM 
WHERE PROJ_NAME = <project name> 

AND PROJECT.PROJ_NO = PROJ_SUB.PROJ_NO 
AND PROJ_SUB.SUBSY_ID = SUB_COM.SUBSY_ID; 

Similarly, the view V SUBSYSTEM INFO allows subsystem information to be selected 
using the following query: 

SQL> SELECT * FROM V_SUBSYSTEM_INFO 
WHERE PROJ_NAME = <project name>; 

This is equivalent to 

SQL> SELECT SUB_PRE, NAME, FUNCTION, SUB_DATE, PROJ_NAME 
FROM PROJECT, PROJ_SUB, SUBSYSTEM 
WHERE PROJ_NAME = <project name> 

AND PROJECT.PROJ_NO = PROJ_SUB.PROJ_NO 
AND PRO J_S UB . SUBS Y_ID = SUBSYSTEM.SUBSY_ID; 

Finally, the view V_PROJ_SUB_ACT is a shortcut to retrieve the activity hours charged to a 
particular subsystem. Thus, 

SQL> SELECT * FROM V_PROJ_SUB_ACT 
WHERE PROJ_NAME = <project name> 

AND SUB_PRE = <subsystem prefix>; 

is equivalent to 

SQL> SELECT PROJ_NAME, SUB_PRE, ACTIVITY, ACT_HR 
FROM PROJECT, EFF_PROJ, EFF_SUB, EFF_ACT 
WHERE PROJ_NAME =<project name> 

AND PROJECT.PROJ_NO = EFF_PROJ.PROJ_NO 
AND EFF_PROJ.PJD = EFF_SUB.P_ID 
AND SUBPRE = <subsystem prefix> 

AND EFF_SUB PS_ID = EFF_ACT.EFF_ID; 

5.3.9 Spooling Output and Saving Queries 

All the queries presented displayed their results on the terminal screen. To create a permanent 
copy of the query results, it is necessary to spool the query session, or at least part of it, to a 
file. This can be accomplished with the following command: 

SQL> SPOOL <VMS file name>; 
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If no file extension is supplied as part of the file name, a file is created in the current default 
directory with the extension .LIS. After this command is entered, any queries executed and 
the associated results are written to this file, as well as displayed on the screen. Spooling can 
be turned off, with the following command: 

SQL> SPOOL OFF; 

It is also useful to save the contents of the current command buffer and reload it at some 
future time. The first step can be accomplished with the following commands: 

SQL> SAVE <VMS file name>; 

If no file extension is supplied as part of the file name, a file is created in the current default 
directory with the extension .SQL. This query can be reloaded into the command buffer by 
using the following command: 

SQL> GET <VMS file name>; 

This command searches the current default directory for the file name specified. If no 
extension is supplied in the file name, it searches for a file with extension .SQL. The loaded 
query may now be executed or listed with / or L as described in Section 5.3.3. 

This section presents enough about ad hoc database queries to enable the user to access any 
particular item of software engineering data in which he or she is interested. It does not, 
however, cover all of the features in SQL*Plus that facilitate data retrieval. Some additional 
capabilities include displaying computed columns, simple pattern matching in WHERE 
clauses, conversion between data types, renaming column headings and defining display 
formats, parameterizing queries, computing statistics on groups of records, and printing 
them on break points when the value of a particular column changes. Readers who are 
interested in these and other advanced features should refer to Reference 4. 

5.4 QUERY LIBRARY 

A collection of commonly used, generalized queries is organized into a library on the STL 
VAX- 11/780. The library includes a search facility with predefined commands to aid the 
users in locating appropriate queries to retrieve desired information. The queries are grouped 
into categories by the type of data they retrieve, as follows: 

• Projects — General project data, statistics 

• Effort — Personnel and services hours, activity hours 

• Changes — Change and error data from CRFs 

• Estimates — Estimated statistics and phase dates 

• Growth — Growth history data 

• Computers — Computer resource data 
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• Components — Component data from COFs 

• Programmers — Programmer hours, activities 

• Other — Miscellaneous queries not covered above 

The search facility prompts for a category and provides a brief description of all queries 
available under that category. A help command is also available that provides instructions for 
using the library and lists the categories available. 

Most of the queries prompt for parameters such as project name and date. The user should 
note the following two important constraints: 

1 . All character data must be typed in UPPER CASE 

2. All dates must be entered in the format DD-MMM-YY (e.g., 01-JAN-89) 

Once a user with database access (Section 5.1) has logged onto the VAX, the following 
command is typed to connect to SQL*Plus: 

$ SQLPLUS 

After supplying an ORACLE user ID and password at the prompts, the user is placed in an 
interpretive environment from which he or she may use the query library. The command line 
prompt 

SQL> 

is displayed, signaling that the system is waiting for a SQL command. Online query library 
help is available by typing 

SQL> START QLIB:QHELP 

NOTE: The symbol “@” can be used in place of the word “START” (i.e., 
@QLIB:QHELP) 

The available help information on the query library will be displayed. To view a list of 
available queries and their associated description, type the following: 

SQL> START QLIB:SEARCH 

The user will be prompted for the name of one of the above categories. 

If the user is unsure of the category names, he or she should type a question mark (?) and all 
categories will be listed. Once the desired query has been located, the query can be executed 
by typing 

SQL> START QLIB:<query name> 

All requested parameters should then be entered (note the previously mentioned constraints ) . 
If the user wants to save the result, the following steps should be executed: 

SQL> SPOOL coutput file> 

SQL> START QLIB:<query name> 

SQL> SPOOL OFF 
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The output will be located in user’s directory and appear as /output file/.LIS. Once the user 
has completed use of the library, he/she can enter ad hoc queries (Section 5.3) or exit from 
SQL*Plus by typing 

SQL> EXIT 

The system prompt will be displayed. 


1 0004437L 


5-14 


APPENDIX A— ENCODED FIELDS AND ALLOWABLE VALUES 


This appendix lists all the codes used throughout the SEL database and their corresponding 
values. Items are listed alphabetically according to the field in which the code is stored. 
Exceptions to this are CL_ACnVTTY, DATA.AVAIL, and QA.STATUS. The CL_AC- 
'l'lVl'lT codes are the Cleanroom PRF values that are stored in the ACTIVITY field of the 
EFF_ACT table. DATA_AVAIL and QAJSTATUS codes are stored only in the VALIDA- 
TION table, but are included in the VAL_DATA_AVAIL and VAL_QA_STATUS views, 
respectively. 


Fields Where Used 

Code 

ACnVE_STATUS 

ACT_DEV 

ACnVE_STATUS 

ACT_MAINT 

ACITVE_STATUS 

DISCONT 

ACnVE_STATUS 

INACTIVE 

ACTIVITY 

ACCTEST 

ACTTVITY 

CREDES 

ACTIVITY 

DEBUG 

ACTIVITY 

INTTEST 

ACTIVITY 

OTHER 

ACTIVITY 

PREDES 

ACTIVITY 

RDREVCOD 

ACTIVITY 

RDREVDES 

ACTIVITY 

SUPPORT 

ACTIVITY 

TSTCODUN 

ACTTVITY 

WRCODE 

ADA FEATURE 

DATATYPE 


Value (Description) 

Data collection is active; project is in 
development 

Data collection is active; project is in 
maintenance 

Data collection discontinued; data for 
the project are incomplete; no plan to 
validate data 

The project has been completed and no 
more data are being collected 

Acceptance test 

Create design 

Debugging 

Integration test 

Other 

Predesign 

Read/review code 

Read/review design 

Support 

Test code units 

Write code 

Data typing 
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Fields Where Used 

Code 

ADA_FEATURE 

EXCEPT 

ADA_FEATURE 

GEN 

ADA_FEATURE 

OTHER 

ADA_FEATURE 

PACK 

ADA_FEATURE 

SUBPROG 

ADA_FEATURE 

SYSDEPF 

ADA_FEATURE 

TASK 

CH.CAUSE 

CODE 

CH.CAUSE 

DESIGN 

CH_CAUSE 

OTHER 

CH_CAUSE 

PRECH 

CH_CAUSE 

REQMTSPEC 

CH_CLASS 

COMPUTE 

CH_CLASS 

DATAVAL 

CH_CLASS 

INTT 

CH_CLASS 

INTERE 

CH_CLASS 

INTER! 

CH_CLASS 

LOGIC 

CH_CLASS 

OTHER 

CH_OBJECT 

CODE 

CH_OBJECT 

DESIGNDOC 

CH_OBJECT 

OTHER 

CH_OBJECT 

REQMTDOC 

CH_OBJECT 

SYSDESC 

CH_OBJECT 

USERGUIDE 

CH_TYPE 

ADENC 

CH_TYPE 

ERRCO 


Value (Description) 

Exceptions 

Generics 

Other 

Program structure and packaging 
Subprograms 

System dependent features 

Tasking 

Code 

Software Design 
Other 

Previous Change 

Requirements/functional specifications 

Computational 

Data (value or structure) 

Initialization 
Interface (external) 

Interface (internal) 

Logic/control structure 

Other 

Code 

Design document 
Other 

Requirements/specifications document 
System description 
User’s guide 

Adaptation to environment change 
Error correction 
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Fields Where Used 


Code 


Value (Description) 


CHTYPE 

EMPCM 

CH_TYPE 

IMPRE 

CH_TYPE 

IMPUS 

CH_TYPE 

IN/DE 

CH_TYPE 

OPTSA 

CH_TYPE 

OTHCH 

CH_TYPE 

PLANE 

CL_ACnVTTY 

CLACCTEST 

CL_ACTTVTTY 

CLCREDES 

CL_ACTTVTTY 

CUNDTEST 

CL_ACnVTTY 

CLOTHER 

CL_ACnVITY 

CLPREDES 

CL_ACTTVTTY 

CLPRETEST 

CL_ACnVTTY 

CLRDREVCOD 

CL_ACTTVTTY 

CLRESPSFR 

CL_ACnVITY 

CLVEREVDES 

CL_ACnVITY 

CLWRCODE 

CL_ACTTVTTY 

SUPPORT 

COM_TYPE 

ADAGENB 

COM_TYPE 

ADAGENS 

COM_TYPE 

ADAPACKB 


Improvement of clarity, maintain- 
ability, or documentation 

Implementation of requirements 
change 

Improvement of user services 

Insertion/deletion of debug code 

Optimization of time/space/accuracy 

Other change type 

Planned enhancement 

Cleanroom acceptance test 

Cleanroom system, subsystems, or 
components design 

Cleanroom system components testing 
by independent tester 

Cleanroom other hours, i.e., manage- 
ment, meetings, documentation, etc. 

Cleanroom predesign, such as 
requirements analysis 

Cleanroom pretest 

Cleanroom code read and code verifi- 
cation 

Cleanroom response to tester reported 
problems and solution implementation 

Cleanroom design verification and 
review, including meetings, reviews, or 
walkthroughs 

Cleanroom system components coding 

Cleanroom support 

Ada generic body 

Ada generic specification 

Ada package body 
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Fields Where Used 

COM_TYPE 

COM.TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM.TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

COM_TYPE 

DATA_AVAIL 

DATA.AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA AVAIL 


Code 

Value (Description) 

ADAPACKS 

Ada package specification 

ADASUBB 

Ada subprogram body 

ADASUBS 

Ada subprogram specification 

ADATASKB 

Ada task body 

ADATASKS 

Ada task specification 

ADAUNSPEC 

Ada source code (type unspecified) 

ALC 

Assembly language component 

BLOCKDA 

BLOCK DATA component 

DISPALY 

Dispaly identification 

FORTRAN 

FORTRAN source code 

ENCL 

Include file 

JCL 

Job control language 

MENDEF 

Menu definition or help file 

NAMELT 

NAMELIST or parameter list 

OTHER 

Other type of component 

PASCAL 

Pascal source code 

REFDATA 

Reference data file 

COF 

Component origination information 
available 

COM_NAME 

Component names available 

CPU 

Project computer resources available 

CRF 

Component change information avail- 
able 

EFF_PROJ 

Manpower effort data at the project 
level available 

EFF_SERV 

Services effort data (Tech. Pubs., 
Secretary, etc.) available 

EFF_SPEC 

Manpower effort data for special acti- 


vities (rework, reuse, etc.) available 
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Fields Where Used 


DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA_AVAIL 

DATA-AVAIL 

DATA-AVAIL 

EFF_COM_CH 

EFF_COM_CH 

EFF_COM_CH 

EFF_COM_CH 

EFF_COM_CH 

EFF_ISO_CH 

EFF_ISO_CH 

EFF_ISO_CH 

EFF_ISO_CH 

EFF_ISO_CH 

ERR_ACAUSE 

ERR_ACAUSE 
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Code 

Value (Description) 

EFF_SUB 

Manpower effort data at the subsystem 
level available 

EST_SCH 

Estimated project phase schedules 
available 

EST_STAT 

Estimated project statistics (LOC, 
effort data, component data) available 

FIN_CPU 

Closed project — Final computer 
resources available 

FIN_SCH 

Closed project — Final phase dates 
available 

FIN_STAT 

Closed project — Final statistics (LOC, 
effort, component data) available 

GRH 

Project growth data available 

SAP 

Closed project — Detailed component 
analysis available 

SEF 

Close project — Sujective evaluation 
data available 

SIF 

Subsystem information available 

1HR 

1 hour or less 

1DAY 

1 hour to 1 day 

3 DAY 

1 day to 3 days 

NDAY 

More than 3 days 

NOTDET 

Not determined 

1HR 

1 hour or less 

1DAY 

1 hour to 1 day 

3 DAY 

1 day to 3 days 

NDAY 

More than 3 days 

NOTDET 

Not determined 

FEATUREC 

Confused features 

FEATUREM 

Misunderstood features 
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Fields Where Used 

Code 

ERR_ACAUSE 

INCOF 

ERR_ACAUSE 

INTERACT 

ERR_ARES 

MEMORY 

ERR_ARES 

NOTE 

ERR_ARES 

NTEAM 

ERR_ARES 

OTHER 

ERR_ARES 

REFMAN 

ERR_ARES 

TEAM 

ERR_CLASS 

COMPUTE 

ERR_CLASS 

DATAVAL 

ERR_CLASS 

ENIT 

ERR_CLASS 

INTERE 

ERR_CLASS 

ENTERI 

ERR_CLASS 

LOGIC 

ERR_CLASS 

NOTDET 

ERR_SOURCE 

CODE 

ERR_SOURCE 

DESIGN 

ERR_SOURCE 

FUNSPEC 

ERR_SOURCE 

NOTDET 

ERR_SOURCE 

PRECH 

ERR_SOURCE 

REQMT 

ERR_TOOLS 

CMS 

ERR_TOOLS 

COMPI 

ERR_TOOLS 

DECTM 

ERR_TOOLS 

LSE 

ERR_TOOLS 

OTHER 

ERR_TOOLS 

PCA 


Value (Description) 

Features applied incorrectly 
Misunderstood interaction of features 
Own memory 
Class notes 

Someone not on project team 
Other 

Ada reference manual 

Own project team member 

Computational 

Data value or structure 

Initialization 

Interface (external) 

Interface (internal) 

Logic/control structure 
Not determined 
Code 
Design 

Functional specifications 

Not determined 

Previous change 

Requirements 

Code Management System 

Compiler 

DEC Test Manager 
Language sensitive editor 
Other 

Performance and coverage analyzer 
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Value (Description) 


Fields Where Used 

Code 

ERR_TOOLS 

SCA 

ERR_TOOLS 

SYMDEB 

FTNAL_ORIGIN_CAT 

EXTMO 

FINAL_ORIGIN_CAT 

NEW 

FINAL_ORIGIN_CAT 

OLDUC 

FINAL_ORIGIN_CAT 

SLMOD 

FUNCTION 

CPEXEC 

FUNCTION 

DPDC 

FUNCTION 

GRAPH 

FUNCTION 

MATHCOMP 

FUNCTION 

REALTIME 

FUNCTION 

SYSSERV 

FUNCTION 

USERINT 

MAINT_ACT 

ACCBENTEST 

MAINT_ACT 

IMPLEMENT 

MAINT_ACT 

ISOLATION 

MAINT_ACT 

OTHER 

MAJNT_ACT 

REDESIGN 

MAINT_ACT 

UNSYSTEST 

MAINT_CH_TYPE 

ADAPTATION 

MAINT CH TYPE 

CORRECTION 


Source code analyzer 
Symbolic debugger 
Extensively modified 
Completely new 
Old (unchanged) 

Slightly modified 
Control processing/executive 
Data processing/data conversion 
Graphics and special device support 
Mathematical/computational 
Real-time control 
System services 
User interface 

Hours spend on acceptance/benchmark 
testing 

Hours spend on changing a system, 
code and the associated documentation 
included 

Hours spend on understanding the 
failure or request for enhancement of 
adaptation 

Hours spend on other maintenance 
activities 

Hours spent on redesigning a system 

Hours spend on unit/system testing 

Adaptation (response to change of 
operational environment) 

Correction (system did not satisfy its 
requirements) 
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Fields Where Used 


Code 


Value (Description) 


MAINT_CH_TYPE 

ENHANCEMNT 

Enhancement (response to change of 
requirements) 

MAINT_CL AS S 

ADAPTATION 

Hours spend on maintenance with 
modifying a system to adapt to a 
change 

MAINT_CLASS 

CORRECTION 

Hours spend on maintenance with a 
system failure 

MAINT_CLASS 

ENHANCEMNT 

Hours spent on maintenance with a 
system failure 

MAINT_CL AS S 

OTHER 

Hours spent on other maintenance 
activities 

MAINT_COM_CH 

1HR 

1 hour or less 

MAINT_COM_CH 

1DAY 

1 hour to 1 day 

MAINT_COM_CH 

1WEEK 

1 day to 1 week 

MAINT_COM_CH 

1 MONTH 

1 week to 1 month 

MAINT_COM_CH 

1 MONTHMORE 

More than 1 month 

MAINT_ISO_CH 

1HR 

1 hour or less 

MAINT_ISO_CH 

1DAY 

1 hour to 1 day 

MAINT_ISO_CH 

1WEEK 

1 day to 1 week 

MAINT_ISO_CH 

1 MONTH 

1 week to 1 month 

MAINT_ISO_CH 

1 MONTHMORE 

More than 1 month 

MEASURE_CODE 

ACCTSTONE 

Number of acceptance tests executed at 
least one time 

MEASURE_CODE 

ACCTSTPASS 

Number of acceptance tests passed 

MEASURE_CODE 

ACCTSTRUN 

Number of acceptance test runs, 
including reruns 

MEASURE_CODE 

DISCRES 

Number of discrepancies resolved 

MEASURE_CODE 

MODCODE 

Number of modules completed 

MEAS URE_CO DE 

MODDESIGN 

Number of modules designed 
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Fields Where Used 

Code 

MEASURE_CODE 

QUESTANS 

MEASURE_CODE 

SPECMO DIMP 

MEASURE_CODE 

SYSTSTONE 

MEASURE_CODE 

SYSTSTPASS 

MEASURE_CODE 

SYSTSTRUN 

MEAS_TYPE 

PM01 

MEAS_TYPE 

PM02 

MEAS_TYPE 

PM03 

MEAS_TYPE 

PM04 

MEAS_TYPE 

PM05 

MEAS_TYPE 

PM06 

MEAS_TYPE 

ST07 

MEAS_TYPE 

ST08 

MEAS_TYPE 

ST09 

MEAS_TYPE 

ST10 

MEAS_TYPE 

TM11 

MEAS_TYPE 

TM12 

MEAS_TYPE 

TM13 

MEAS_TYPE 

TM14 

MEAS_TYPE 

TM15 

MEAS_TYPE 

PC 16 

MEAS TYPE 

PC17 


Value (Description) 

Number of questions answered by 
analysts 

Number of specification modifications 
implemented 

Number of system tests executed at 
least one time 

Number of system tests passed 

Number of system test runs, including 
reruns 

Problem difficulty 

Tightness of schedule constraints 

Requirements stability 

Quality of specification documents 

Requirements for documentation 

Rigor of formal reviews 

Ability of development team 

Development team experience with 
application 

Development team experience with 
environment 

Stability of development team 
composition 

Project management performance 

Project management experience with 
application 

Stability of project management team 
Project planning discipline 
Degree project plans followed 
Modem programming practices 
Disciplined change/question tracking 


1 000443 7L 


A 9 



Fields Where Used 


Code 


Value (Description) 


MEAS_TYPE 

PC18 

MEAS_TYPE 

PC19 

MEASJTYPE 

PC20 

MEASJTYPE 

PC21 

MEAS_TYPE 

PC22 

MEAS_TYPE 

PC23 

MEAS_TYPE 

PC24 

MEAS_TYPE 

EN25 

MEAS_TYPE 

EN26 

MEASJTYPE 

EN27 

MEAS_TYPE 

EN28 

MEAS_TYPE 

EN29 

MEAS_TYPE 

EN30 

MEAS_TYPE 

PT31 

MEASJTYPE 

PT32 

MEAS_TYPE 

PT33 

MEAS_TYPE 

PT34 

MEAS_TYPE 

PT35 

MEAS_TYPE 

PT36 

NOTEJTYPE 

CLOSEOUT 

NOTE_TYPE 

COMPACCTS 


Use of disciplined requirements analy- 
sis methodology 

Use of disciplined design methodology 
Use of disciplined testing methodology 
Use of tools 
Use of test plans 

Use of quality assurance procedures 

Use of configuration management 
procedures 

Degree of access to development 
system 

Programmers per terminal 

Development machine resource 
constraints 

System response time 

System hardware and support software 
stability 

Software tool effectiveness 

Delivered software supports 
requirements 

Quality of delivered software 

Quality of design present in delivered 
software 

Quality/completeness of software 
documentation 

Timely software delivery 

Smoothness of acceptance testing 

Project closeout status 

Computer accounts to monitor 
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Fields Where Used 


Code 


Value (Description) 


NOTE_TYPE 

COMPSYS 

NOTEJTYPE 

CONTACTS 

NOTE_TYPE 

CONTRLLIB 

NOTE_TYPE 

DATAAVAIL 

NOTE_TYPE 

FORMSCOL 

NOTEJTYPE 

GENMESS 

NOTE_TYPE 

GHTOOL 

NOTEJTYPE 

languages 

NOTEJTYPE 

PROJNAME 

NOTEJTYPE 

TASKNO 

ORIJTYPE 

EXTMO 

ORIJTYPE 

NEW 

ORIJTYPE 

OLDUC 

ORI_TYPE 

SLMOD 

PHASE_CO 

ACCTE 

PHASE_CO 

CLEAN 

PHASE_CO 

CODET 

PHASE_CO 

DESGN 

PHASE_CO 

MAINT 

PHASE_CO 

REQNT 

PHASE_CO 

SYSTE 

PROJ_TYPE 

AGSS 

PROJJTYPE 

ATTITUDE 

PROJ_TYPE 

DATABASE 

PROJJTYPE 

GRAPH/UI 

PROJ TYPE 

MP&A 


Development and operational 
computer system 

Project contacts 

Names of controlled libraries 

Type of data available 

SEL forms collected 

General messages 

Growth history tool used 

Languages used 

Project full name 

Task numbers and corresponding years 
Extensively modified 
Completely new 
Old (unchanged) 

Slightly modified 
Acceptance test 
Cleanup 

Code and test (implementation) 

Design 
Maintenance 
Requirement definition 
System test 

Attitude ground support system 

Attitude oriented 

Database 

Graphics/user interface 
Mission planning and analysis 
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Fields Where Used 


PROJ_TYPE 

PROJ_TYPE 

PROJ_TYPE 

PROJ.TYPE 

PROJ_TYPE 

PURPOSE 

PURPOSE 

PURPOSE 

PURPOSE 

PURPOSE 

PURPOSE 

PURPOSE 

PURPOSE 

QA_STATUS 

QA_STATUS 

SECOND_L 

SECOND_L 

SECOND_L 

SECOND_L 

SECOND_L 

SECOND_L 

SECOND.L 

SECOND_L 

SECOND_L 

SECOND_L 

SECOND_L 
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Code Value (Description) 


ORBIT 

Orbit oriented 

OTHER 

Other 

REALTIME 

Real time processing 

SIMULATOR 

Simulator 

TOOL 

Software tool 

AD ADA 

Ada data abstraction 

AD APR 

Ada process abstraction 

ALCOMP 

Algorithmic/computational 

CNTRMOD 

Control module 

DATRA 

Data transfer 

INTOP 

Interface to operating system 

IOPRO 

I/O processing 

LODEC 

Logic/decision 

HCCORRECT 

Hand-checked: correct 

HCERROR 

Hand-checked: errors found 

CAT 

Configuration Analysis Tool 

CMTOOL 

Configuration management tool 
(e.g. CMS, MMS) 

COMPI 

Compiler 

EDIT 

Editor 

GRADIS 

Graphics display builder 

INTERF 

Interface checker (e.g., RXVP80, 
ANALYZ) 

ISPF 

ISPF 

LINK 

Linker 

LSE 

Language sensitive editor 

OTHER 

Other tools 

PANVAL 

PANVALET 
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Fields Where Used 

Code 

SECOND_L 

PDLPR 

SECOND_L 

REPLP 

SECOND_L 

SAP 

SECOND_L 

SDE 

SECOND.L 

STRANT 

SECOND_L 

SYMDEB 

SECOND_L 

TESTCO 

SP_ACnVITY 

CLMETHOD 

SP_ACTTVTTY 

DOCUMENT 

SP_ACTTVTTY 

ENHANCE 

SP_ACnVITY 

REUSE 

SP_ACirVTTY 

REWORK 

STATUS 

CLOSED 

STATUS 

HCCORRECT 

STATUS 

HCERROR 

STATUS 

UNCHK 

STATUS 

VERAP 

STATUS_CODE 

ACCTST 

STATUS_CODE 

CODE 

STATUS_CODE 

DESIGN 

STATUS_CODE 

DISCREP 

STATUS_CODE 

QUESTIONS 

STATUS.CODE 

SPECMOD 

STATUS_CODE 

SYSTST 

TARGET_CODE 

QUESTSUB 


Value (Description) 

PDL processor 

Requirement language processor 

Source Code Analyzer program 

Software development environment 

Structured analysis tool 

Symbolic debugger 

Test coverage tool 

Methodology understanding or 
discussion 

Document 

Enhance/refine/optimize 

Reuse 

Rework 

Information has been verified and 
validated — Project is closed 

Hand-checked: correct 

Hand-checked: errors found 

Unchecked 

Verified by application 

Acceptance testing status 

Code status 

Design status 

Discrepancy status 

Questions to analysts status 

Specification modification status 

System testing status 

Number of questions submitted to 
analysts 
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Fields Where Used 

Code 

Value (Description) 

TARGET_CODE 

SPECMODREC 

Number of specification modifications 
received 

TARGET_CODE 

TOTACCTST 

Total number of separate acceptance 
tests planned 

TARGET_CODE 

TOTCODE 

Estimated total number of modules to 
be coded 

TARGET_CODE 

TOTDESIGN 

Estimated total number of modules to 
be designed 

TARGET_CODE 

TOTDISCREP 

Total number of discrepancies reported 

TARGET_CODE 

TOTSYSTST 

Total number of separate system tests 
planned 
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APPENDIX B— SAMPLE OPTIMIZED DATABASE QUERIES 


This appendix contains additional examples of SQL queries to augment those presented in 
Section 5.3. These are optimized queries that are written specifically for an ORACLE 
RDBMS environment. In each example, the desired retrieval is first expressed in an English 
statement. This is followed by SQL statements to retrieve the desired data. The user should 
remember that there is often more than one way to formulate a particular query; only one 
method is presented here for each example. 

1. Retrieve the names of all Attitude Ground Support Systems (AGSSs) with more 
than 100,000 total lines of code. 

SQL> SELECT PROJ.NAME 

FROM PROJ_STAT, PROJECT 
WHERE T_LINE > 100000 
AND PROJ_TYPE = ‘AGSS’ 

AND PROJECT.PROJ_NO = PROJ_STAT.PROJ_NO; 

2. Retrieve the names of all persons who have submitted PRFs for project ‘XYZ’. 

SQL> SELECT DISTINCT FULL_NAME 

FROM EFF_FORM, EFF_PROJ, PERSONNEL, PROJECT 
WHERE FORM_TYPE = ‘PRF’ 

AND EFF_PROJ.P_ID = EFF_FORM.P_ID 

AND EFF_PROJ.PROG_ID = PERSONNEL.PROGJD 

AND EFF_PRO J .PRO J_N O = PROJECT.PROJ_NO 
AND PROJ_NAME = ‘XYZ’; 

3. For project ‘ XYZ’, list alphabetically all component names (with subsystem pre- 
fixes) that do not have COF data. 

SQL> SELECT SUB_PRE, COM_NAME 
FROM V_PROJ_COM 
WHERE PROJ_NAME= ‘XYZ’ 

AND COM_NO NOT IN 

(SELECT COM_NO FROM COM_SOURCE) 

ORDER BY SUB_PRE, COM_NAME; 
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4. Retrieve the number of error correction changes for project ‘ XYZ ’ that took more 
than 3 days to implement. 

SQL> SELECT COUNT (CHANGE_NO) 

FROM CHANGE 
WHERE CHANGE_NO IN 

(SELECT DISTINCT CHANGE _NO 
FROM CHANGE_COM, V_PROJ_COM 
WHERE CHANGE_COM.COM_NO = 
V_PROJ_COM.COM_NO 
AND PROJ_NAME = ‘XYZ’) 

AND EFF_COM_CH = ‘NDAY’ 

AND CH_TYPE = ‘ERRCO’; 

5. Retrieve the total design hours for project ‘XYZ’. This query may be interpreted 
two ways. 

a. Retrieve all hours charged to design activities. 

SQL> SELECT SUM (ACT_HR) 

FROM EFF_ACT 
WHERE EFF_ID IN 

(SELECT P_ID 

FROM EFF_PROJ, PROJECT 
WHERE EFF_PROJ.PROJ_NO = 

PROJECT.PROJ_NO 
AND PROJ_NAME = ‘XYZ’ 

UNION 

SELECT PS_ID 

FROM EFF_SUB, EFF_PROJ, PROJECT 
WHERE EFF_PROJ.P_ID = EFF_SUB.P_ID 
AND EFF_PROJ.PROJ_NO = PROJECT.PROJ_NO 

AND PROJ_NAME = ‘XYZ’) 

AND ACTIVITY IN (‘CREDES’, ‘RDREVDES’); 

b. Retrieve all manpower hours charged during the design phase. 

First, find the design phase start and end dates. 

SQL> SELECT START_DATE, END_DATE 

PROJ_EST_PHASE, PROJECT 
WHERE SUB _D ATE = 

(SELECT MAX (SUB_DATE) 

FROM PROJ_EST_PHASE 

WHERE PROJ_NO = PROJECT.PROJ_NO) 
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AND PHASE_CO = ‘DESIGN’ 

AND PROJ_EST_PHASE.PROJ_NO = 

PROJECT.PROJ_NO 
AND PROJ.NAME = ‘XYZ’ 

Second, find all activity hours between these dates 

SQL> SELECT SUM (ACT_HR) 

FROM EFF_ACT 
WHERE EFFJDIN 

(SELECT P_ID 

FROM EFF_PROJ, PROJECT 

WHERE SUB_DATE BETWEEN <start date> 

AND <end date> 

AND EFF_PROJ.PROJ_NO = PROJECT.PROJ_NO 
AND PROJ_NAME = ‘XYZ’ 

UNION 

SELECT PS_ID 

FROM EFF_SUB, EFF_PROJ, PROJECT 
WHERE SUB_DATE BETWEEN <start date> 

AND <end date> 

AND EFF_PROJ.P_ID = EFF_SUB.P_ID 

AND EFF_PROJ.PROJ_NO = PROJECT.PROJ_NO 

AND PROJ_NAME = ‘XYZ’ 

AND ACTIVITY ! = ‘SUPPORT’); 
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APPENDIX C— SEL DATA COLLECTION FORMS 


This appendix contains all the SEL data collection forms. Most forms are completed by 
programmers and managers of SEL-monitored projects. The PCSF, PMF, PSF, and SPF are 
completed by SEL personnel. 
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CHANGE REPORT FORM 


Name: D21 Approved by:. 

Project: DJ Date: D2 

Section A - Identification 

Describe the change: (What why, how) 


Effect: What components are changed? 


Prefix 

Name 

Version 

D61 

D62 















Effort: What additional components 
were examined in determining 
what change was needed? 


(Attach list if more space is needed) 
Location of developer's source files_ 


month day year 


Need for change determined on: D63 

Change completed (incorporated into system): 064 


ChecK here if change involves 
Ada components (If so, complete 
questions on reverse side) 


Bn 0 


1 hr/less 1 hr/1 day 1/3 days >3 days 


Effort in person time to isolate the change (or error): 

Effort in person time to implement the change (or correction): 


D65 

D66 


D76 


Section B - All Changes 


Type of Change (Check one) 


□ Error correction 
H Planned enhancement 

PI Implementafion of requirements 
change 

Q Improvement of clanty, 

maintainability, or documentation 

□ Improvement of user services 
O Insertion/deletion of debug code 


I I Optimization of time/space/ 
accuracy 

[^Adaptation to environment 
change 

n Other (Describe below) 

D67 


y N 

□ □ 
D68 
□ □ 
D69 
□ □ 
D70 


Effects of Change 

Was the change or correction to one and only one 
component? {Must match Effect in Section A) 

Did you look at any other component? {Must 
match Effort in Section A) 

Did you have to be aware of parameters passed 
explicitly or implicitly (e g., COMMON blocks) to or 
from the changed components 7 


Section C - For Error Corrections Only 


Source of Error 
(Check one) 

Class of Error 
(Check most applicable)* 

Characteristics 
(Check Y or N for all) 

□ Requirements 

□ Functional specifications 

□ Design 

□ Code 

□ Previous change 

D71 

□ Imoalization 072 

QO Logtc/control structure 

(e g., flow of control incorrect) 

|~1 Interface (internal) 

(module-to-module communication) 
n Interface (external) 

(module to external communication) 

□ Data (value or structure) 

(e g., wrong variable used) 

Lj Computational 

(e g,, error in math expression) 

Y N 

Q O Omission error (e.a somethina was left outl 

( | n Commission error le a somethina incorrect was 
Q 74 included) 

□ □ Error was created by transcription (clencal) 

D75 

For Ubranan’s Use Only 

Number D82 

*lf two are equally applicable cneck the 
one higher on the list 

Date 

Entered bv: 
Checked bv: 


NOVEMBER 1991 


Figure C-1 . Change Report Form (CRF) (1 of 2) 
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CHANGE REPORT FORM 

Ada Project Additional Information 

1. Check which Ada feature(s) was involved in this change (Check all that apply) 

□ Data typing □ Program structure and packaging 

D 77 □ Subprograms □ Tasking 

□ Exceptions □ System-dependent features 

f""l Generics D Other, please specify 

(e.g., I/O, Ada statements) 

2. For an error involving Ada components: 

a. Does the compiler documentation or the language D78 (Y/N) 

reference manual explain the feature clearly? ’ 

b. Which of the following is most true? (Check one) 

□ Understood features separately but not interaction 

□ Understood features, but did not apply correctly 

D79 

□ Did not understand features fully 

□ Confused feature with feature in another language 

c. Which of the following resources provided the information 

needed to correct the error? (Check all that apply) 

□ Class notes □ Own memory 

□30 □ Ada reference manual □ Someone not on team 

□ Own project team member □ Other 

d. Which tools, if any, aided in the detection or correction of this error? (Check all that apply) 

□ Compiler □ Source Code Analyzer 

□ Symbolic debugger □ P&CA (Performance and Coverage Analyzer) 

D81 

□ Language-sensitive editor □ DEC test manager 

□ CMS □ Other, specify 

3. Provide any other information about the interaction of Ada and this change 

that you feel might aid in evaluating the change and using Ada 
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Figure 0-1. Change Report Form (CRF) (2 of 2) 
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COMPONENT ORIGINATION FORM 


Identification 

Name: 

Project: D 1 

Date: ^ 

Subsystem Prefix: 

Component Name: D53 

Configuration Management Information 


Date entered into controlled library (supplied by configuration manager): ^4 

Library or directory containing developer's source file: 


Member name: 


Relative Difficulty of Developing Component 

D55 

Please indicate your judgment by circling one of the numbers below. 

Easy Medium Hard 


1 2 3 4 5 


Origin 

D56 

If the component was modified or derived from a different project, please indicate the 
approximate amount of change and from where it was acquired; if it was coded new (from 
detailed design) indicate NEW. 

NEW 

For Librarian's Use Only 

Extensively modified (more than 25% of 

Number: 

statements changed) 
Sliahtlv modified 
Old (unchanged) 

Date: 

Entered by: 
Checked by: 

If not new, what project or library is it from? 


Component or member name: 

Type of Component (Check one only) 

D57 

INCLUDE file (e.g., COMMON) 

Control language (e.g., JCL, DCL, CLIST) 
ALC (assembler code) 

FORTRAN source 
Pascal source 
C source 

NAMELIST or parameter list 
Display identification (e.g., GESS, FDAF) 
Menu definition or help 
Reference data files 

BLOCK DATA file 

Ada subprogram specification 

Ada subprogram body 

Ada package specification 

Ada package body 

Ada task body 

Ada generic instantiation 

Ada generic specification 

Ada generic body 

Other 

Purpose of Executable Component 

D58 

For executable code, please identify the major purpose or purposes of this component. 
(Check all that apply). 

I/O processing 
Algorithmic/computational 
Data transfer 
Loqic/decision 

Control module - 

Interface to operating system ® 

Process abstraction | 

Data abstraction § 


NOVEMBER 1991 


Figure C-2. Component Origination Form (COF) 
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DEVELOPMENT STATUS FORM 


Name: Ud 1 

Project: gl Date: 

Please complete the section(s) that is appropriate for the current status of the project. 


Design Status 

Planned total number of components to be designed 
(New, modified, and reused) 

D180 

Number of components designed 
(Prolog and POL have been completed) 

D181 


Code Status 

Planned total number of components to be coded 
(New, modified, and reused) 

D182 

Number of components completed 
(Added to controlled library) 

D183 

I 


Testing Status 


Total number of separate tests planned 


Number of tests executed at least one time 


Number of tests passed 


System Test 


Acceptance Test 



D188 

i 

D189 


Discrepancy Tracking Status (from beginning of system testing) 


Total number of discrepancies reported 


Total number of discrepancies resolved 


Specification Modification Status (from beginning of requirements analysis) 

Total number of specification modifications received j 

D194 

Total number of specification modifications completed (implemented) 

D195 


Requirements Questions Status {from beginning of requirements analysis) 


Total number of questions submitted to analysts 
Total number of questions answered by analysts 


Check here if there 
are no changes 



Number: _ 

Date: 

Entered by: . 
Checked by: 


For Librarian’s Use Only 


D198 
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MAINTENANCE CHANGE REPORT FORM 

D21 OSMR Number: D162 


For Librarian s Use Only 

tr 0178 


Project: 


Entered by: 
Checked by: 




SECTION A: Change Request Information 

Functional Description of Change: 



What was the type of modification? 

Correction 

33 Enhancement 

Adaptation 


What caused the change? 

Requirements/specifications 

Software design 

Code 

Previous change 

Other 


SECTION B: Change Implementation Information 

Components Added/Changed/Deleted: 


Estimate effort spent isolating/determining the change: 
Estimate effort to design, implement, and test the change: 


1 hr to 1 day to 1 week to 
< Ihr 1 day 1 week 1 month > ^ month 



Check ail changed objects: qj 

Requirements/Specifications Document 

Design Document 

Code 

System Description 

User's Guide 

Other 


if code changed, characterize the change (check most 
applicable): 

Initialization 0168 

Logic/control structure 

(e.g., changed flow of control) 

Interface (internal) 

(module to module communication) 

Interface (external) 

(moduie-to-externai communication) 

Data (value or structure) 

(e.g., variable or value changed) 

Computational 

(e.g., change of math expression) 

Other (none of the above apply) 


Estimate the number of lines of code (including comments): 69 

added 

Enter the number of components: D172 D173 D174 

added changed deleted 

Enter the number of the added components that are: — EL1Z5 — 


D170 

changed 


D171 

deleted 


D175 D176 D177 

totally new totally reused reused with 

modifications 


NOVEMBER 1991 


Figure C-4. Maintenance Change Report Form (MCRF) 


1 000443 7L 


10004437*g023 








Name: ^ 

Personnel Resources Form 


Project: 

Date (Friday): 

D22 


SECTION A: Total Hours Spent on Project for the Week: 

SECTION B: Hours By Activity (Total of hours in Section B should equal total hours in Section A) 


Activity 

Activity Definitions 

Hours 

Predesign 

Understanding the concepts of the system. Any work prior to the actual design (such 
as requirements analysis). 

D23 

Create Design 

Development of the system, subsystem, or components design. Includes development 
of POL, design diagrams, etc. 

D24 

Read/Review Design 

Hours spent reading or reviewing design. Includes design meetings, formal and informal 
reviews, or walkthroughs. 

D25 

Write Code 

Actually coding system components. Includes both desk and terminal code development. 

D26 

Read/Review Code 

Code reading for any purpose other than isolation of errors. 


Test Code Units 

Testing individual components of the system. Includes writing test drivers. 

D28 

Debugging 

Hours spent finding a known error in the system and developing a solution. Includes gen- 
eration and execution of tests associated with finding the error. 

D29 

Integration Test 

Writing and executing tests that integrate system components, including system tests. 

D30 

Acceptance Test 

Runntng/supporting acceptance testing. 

D31 

Other 

Other hours spent on the project not covered above. Includes management, meetings, 
training hours, notebooks, system descriptions, user's guides, etc. 

D32 


SECTION C: Effort On Specific Activities (Need not add to A) 

(Some hours may be counted in more than one area; view each activity separately) 


Rework: Estimate of total hours spent that were caused by unplanned changes or errors. Includes D33 

effort caused by unplanned changes to specifications, erroneous or changed design, errors or 
unplanned changes to code, changes to documents. (This includes all hours spent debugging.) 

Enhancing/Refining/Optimizing: Estimate of total hours spent improving the efficiency or clarity of design, or D34 
code, or documentation. These are not caused by required changes or errors in the system. 

Documenting: Hours spent on any documentation of the system. Includes development of design documents, D35 
Prologs, in-line commentary, test plans, system descriptions, user's guides, or any other system 
documentation. 


Reuse: Hours spent in an effort to reuse components of the system. Includes effort in looking at other |D36 

svstem(s) desian. code, or documentation. Count total hours in searchina. aoDlvina. and testina. 



NOVEMBER 1991 


Figure C-5. Personnel Resources Form (PRF) 
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Name._ 

Project:, 


Personnel Resources Form 

(CLEANROOM VERSION) 

Date (Friday): . 


SECTION A: Total Hours Spent on Project for the Week: 


SECTION B: Hours By Activity (Total of hours in Section B should equal total hours in Section A) 


Activity 

Activity Definitions 

Hours 

Predesign 

Understanding the concepts of the system. Any work prior to the actual design (such 
as requirements analysis). 

D199 

Pretest 

Developing a test plan and building the test environment, includes generating test cases, 
generating JCL, compiling components, building libranes, and defining inputs and 
probabilities. 

0200 

Create Design 

Development of the system, subsystem, or components design. Includes box structure 
decomposition, stepwise refinement, development of POL, design diagrams, etc. 

0201 

Verify/Review Design 

Includes design meetings, formal and informal reviews, and walkthroughs. 

0202 

Write Code 

Actually coding system components. Includes both desk and terminal code development. 

D203 

Read/Review Code 

Code reading for any purpose other than isolation of errors. Includes verifying and 
reviewing code for correctness. 

D204 

Independent Test 

Executing and evaluating tests of system components. 

D205 

Response to SFR 

Isolating a tester-reported problem and developing a solution. Includes writing and 
reviewing design or code to isolate and correct a tester-reported problem. 

D206 

Acceptance Test 

Running/supporting acceptance testing. 

D207 

Other 

Other hours spent on the project not covered above. Includes management, meetings, 
training nours, notebooks, system descriptions, user's guides, etc. 

0208 


SECTION C: Effort On Specific Activities 


Methodology Understanding/Discussion: Estimate the total hours spent learning, discussing, reviewing or 
attempting to understand cleanroom-related methods and techniques, includes all time spent in training. 


For Librarian's Use Onty 

Number: D21 0 

Date: 

Entered by: ___ 

Checked by: _ ___ — 


NOVEMBER 1991 ~ ~ 

Figure C-6. Cleanroom Personnel Resources Form (CLPRF) 
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PROJECT COMPLETION STATISTICS FORM 


Name: 

Project: D1_ 


Phase Dates (Saturdays) 


Phase 


Requirements Definition 


Design 


Implementation 


System Test 


Acceptance Test 


Cleanup 


Maintenance 


Project End 


Start Date 


D84 


D85 


D86 


D87 


D88 


D89 


D90 


D91 


Staff Resource Statistics 


Technical and _ _ 

Management Hours 


Services Hours D93 


Computer Resource Statistics 


Computer 


D38 


CPU hours 


D94 


No. of runs 


D95 



Project Size Statistics 


General Parameters 


Number of subsystems 


Number of components 


Number of changes 


Pages of documentation 



Source Lines of Code 

Total 

D100 

New 

D101 

Slightly Modified 

D102 

Extensively Modified 

D21 1 

Old 

D103 

Comments 

D104 


Executable Modules 

Executable Statements 

Statements 

Total 

D105 

Total 

D109 

Total 

D214 

New 

D106 

New 

D110 

New 

D215 

Slightly Modified 

D107 

Slightly Modified 

Dill 

Slightly Modified 

D216 

Extensively Modified 

D212 

Extensively Modified 

D213 

Extensively Modified 

D217 

Old 

D108 

Old 

D112 

Old 

D218 


Note: All of the values on this form are to be actual values at 

the completion of the proiect. The values entered by 
hand by SEL personnel reflect the data collected by 
the SEL during the course of the project. Update 
these according to protect records and supply values 
lor all blank fields. 
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Number 

Oate 

Entered by:_ 
Checked by 


For Librarian's Use Only 


D113 


Figure C-7. Project Completion Statistics Form (PCSF) 
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PROJECT ESTIMATES FORM 


Name: 

Project: D 1 Date: D2 


Project Size Estimates 

Number of subsystems 

D14 

Number of components 

D15 

Source Lines of Code 

Total 

016 

New 

D17 

Modified 

D18 

Old 

D19 


Staff Resource Estimates 

Programmer Hours 

Dll 

Management Hours 

D12 

Services Hours 

D13 


Phase Dates (Saturdays) 

Phase 

Start Date 

Requirements Definitior 

D3 

Design 

D4 

Implementation 

D5 

System Test 

D6 

Acceptance Test 

D7 

Cleanup 

D8 

Project End 

DIO 


Note: 


All of the values on this form are to be 
estimates of projected values at completion 
of the project. This form should be 
submitted with updated estimates every 6 to 
8 weeks during the course of the project. 


Number: 

Date: 

Entered by: 


Checked by: 


For Librarian's Use Only 

D20 
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Figure C-8. Project Estimates Form (PEF) 
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PROJECT MESSAGES FORM 

Name: 

Project: Dj Date: D2 


Messages: 



P4, D61 , D62 
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Figure C-9. Project Messages Form (PMF) 


100 0443 7L 


C-ll 


10004437-g028 



PROJECT STARTUP FORM 

Name: 

Project: 01 Date: 02 

PLEASE PROVIDE ALL AVAILABLE INFORMATION 
Project Full Name: P4, D61 , D62 

Project Type: P2, D60 

j 

Contacts: P4, D61 , D62 

Language: P4, D61 , D62 

Computer System: P4, D61,D62 

Account: P4, D61 , D62 

Task Number: P4, D61 , D62 

Forms To Be Collected: (Circle forms that apply) P4, D61 , D62 

PEF PRF CLPRF DSF SPF SIF COF CCF CRF SEF PCSF WMEF MCRF 

General Notes: P4, D61.D62 







Personnel Names (indicate with * if not in database): 
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Figure C-1 0. Project Startup Form (PSF) 
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SERVICES/PRODUCTS FORM 

Project: 

Date (Friday): 5^ 


COMPUTER RESOURCES 


Computer 

CPU Hours 

No. of Runs 

D38 

D39 

D40 











GROWTH HISTORY 


Components 

D41 

Changes 

D42 

Lines of Code 

D43 


For Librarian's Use Only 

Number: D49 

Date: 

Entered by: 

Checked by: _ 

NOVEMBER 1991 

Figure C-11. Services/Products Form (SPF) 


SERVICES EFFORT 


Service 

Hours 

Tech Pubs 

D44 

Secretary 

D45 

Proj Mgmt 

047 

Other 

D48 
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SUBJECTIVE EVALUATION FORM 



Indicate response by circling the corresponding numeric ranking. 

I. PROBLEM CHARACTERISTICS 

t . Assess the intrinsic difficulty or complexity of the problem that was addressed by the software development. 

D114 1234 5 

Easy Average Difficult 

2. How tight were schedule constraints on project? 

D115 12345 

Loose Average Tight 

3. How stable were requirements over development period? 

Dll 6 1 2 3 4 5 

Loose Average High 

4. Assess the overall quality of the requirements specification documents, including their clanty, accuracy, 
consistency, and completeness. 

^17 1 2 3 4 5 

Low Average High 

5. How extensive were documentation requirements? 

D118 12 3 4 5 

Low Average High 

6. How rigorous were formal review requirements? 

D1 19 12 3 4 5 

Low Average High 

II. PERSONNEL CHARACTERISTICS: TECHNICAL STAFF 

7. Assess overall quality and ability of development team. 

D120 1 2 3 4 5 

Low Average High 

8. How would you characterize the development team's experience and familiarity with the application area of 
the project? 

D121 1234 S 

Low Average High 

9. Assess the development team's expenence and familiarity with the development environment (hardware 
and support software!. 

D122 1 2 3 4 5 

Low Average High 

1 0. How stable was the composition of the development team over the duration of the project? 

D123 1 2 3 4 5 

Loose Average High 


FOR LIBRARIAN'S USE ONLY 


Entered by: 
Checked by: 
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SUBJECTIVE EVALUATION FORM 


III. PERSONNEL CHARACTERISTICS: TECHNICAL MANAGEMENT 

1 1 . Assess the overall performance of project management. 

1 2 3 * 5 

D124 Low Average High 

12. Assess project management's experience and familiarity with the application. 

HI PR 12 3 4 5 

U ^ Low Average High 

13. How stable was project management during the project? 

1 2 3 4 5 

D126 Low Average High 

14. What degree of disciplined project planning was used? 

1 2 3 4 5 

27 Low Average High 

15. To what degree were project plans followed? 

0128 2 a 3 4 Hinh 

Low Average High 

IV. PROCESS CHARACTERISTICS 

16. To what extent did the development team use modern programming practices (POL, top-down 
development, structured programming, and code reading)? 

0129 ’ 2 A 3 4 H 5 h 

Low Average High 

17. To what extent did the development team use well-defined or disciplined procedures to record 
specification modifications, requirements questions and answers, and interface agreements? 

1 2 3 4 5 

D1 30 j_ ow Average High 

18. To what extent did the development team use a well-defined or disciplined requirements analysis 
methodology? 

D1 31 1 2 3 4 5 

Low Average High 

19. To what extent did the development team use a well-defined or disciplined design methodology? 

1 2 3 4 5 

^ 32 Low Average High 

20. To what extent did the development team use a well-defined or disciplined testing methodology? 

D1 33 1 2 3 4 5 

Low Average High 

IV. PROCESS CHARACTERISTICS 

21. What software tools were used by the development team? Check all that apply from the list that follows 
and identify any other tools that were used but are not listed. 


□ Compiler 
D Linker 

□ Editor 

□ Graphic display builder 

□ Requirements language processor 

□ Structured analysis support tool 

□ PDL processor 

□ ISPF 

□ SAP 


□ CAT 

□ PANVALET 

□ Test coverage tool 

□ Interface checker (RXVP80, etc.) 

□ Language-sensitive editor 

□ Symbolic debugger 

□ Configuration Management Tool (CMS. etc.) 

□ Others (identify by name and function) 


22. To what extent did the development team prepare and follow test plans? 
.c 1 2 3 4 5 

33 Low Average High 


Figure C-12. Subjective Evaluation Form (SEF) (2 of 3) 
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SUBJECTIVE EVALUATION FORM 


IV. PROCESS CHARACTERISTICS (CONTD) 

23. To what extent did the development team use well-defined and disciplined Quality assurance procedures 
(reviews, inspections, and walkthroughs)? 

D136 1 2 3 4 5 

Low Average High 

24. To what extent did development team use well-defined or disciplined configuration management 
procedures? 

D137 , 1 2 A 3 4 5 

Low Average High 

V. ENVIRONMENT CHARACTERISTICS 

25. How would you characterize the development team s degree of access to the development system'? 

1 2 3 4 5 

U138 Low Average High 

26. What was the ratio of programmers to terminals? 

1 2 3 4 5 

D139 8:1 4:1 2:1 1:1 1:2 

27. To what degree was the development team constrained by the size of main memory or direct-access 
storage available on the development system? 

D140 Low Average High 

28. Assess the system response time: were the turnaround times experienced by the team satisfactory in 
light of the size and nature of the jobs? 

D141 1 2 3 4 5 

Poor Average Very Good 

29. How stable was the hardware and system support software (including language processors) during the 
project? 

0142 1 2 3 4 5 

Low Average High 


30. Assess the effectiveness of the software tools. 

D143 1 2 3 4 5 

Low Average High 

VI. PRODUCT CHARACTERISTICS 

31 . To what degree does the delivered software provide the capabilities specified in the requirements? 

D144 1 2 3 4 5 

Low Average High 

32. Assess the quality of the delivered software product. 

0145 12 3 4 5 

Low Average High 

33. Assess the quality of the design that is present m the software product. 

D146 1 2 3 4 5 

Low Average High 

34. Assess the quality and completeness of the delivered system documentation. 


D147 Low 


3 

Average 


35. To what degree were software products delivered on time 7 

12 3 4 

D148 Low Average 

36. Assess smoothness or relative ease of acceptance teslma 

1 2 3 4 

D149 Low Average 


Figure C-12. Subjective Evaluation Form (SEF) (3 of 3) 
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SUBSYSTEM INFORMATION FORM 


Name:_ 
Project: . 


Add New Subsystems 



Subsystem 

Name 

Subsystem 

Function 

D51 

D52 




Change Existing Subsystems 


Old Subsystem Prefix 

Action 

(R - Rename, 

New Subsystem Prefix 

(Must exist in the database) 

D - Delete) 

(Must not exist in the database) 


This form is to be completed by the time of the Preliminary Design Review (PDR). An update 
must be submitted each time a new subsystem is defined thereafter. This form is also to be 
used when a subsystem is renamed or deleted. 

Subsystem Prefix: A prefix of 2 to 5 characters used to identify the subsystem when naming 

components 

Subsystem Name: A descriptive name of up to 40 characters 

Subsystem Function: Enter the most appropnate function code from the list of functions below: 


NOVEMBER 1991 

Figure C-13. Subsystem Information Form (SIF) 


USERINT: 

i _ , . 1 DPDC: L/QIQ l l wuwggn ^ WVL* 

For Librarian's use Only REALTIME: Real-time Control 

Number: MATHCOMP: Mathematical/Comput; 

Dae: GRAPH: Graphics and Special t 

Entered by- CPEXEC: Control Processmg/Ex 

Checked by: SYSSERV: System Serv ices 


User Interface 

Data Processing/Data Conversion 
Real-time Control 
Mathematical/Computational 
Graphics and Special Device Support 
Control Processing/Executive 
System Services 
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WEEKLY MAINTENANCE EFFORT FORM 

Name: D21 

Project: 51 Date (Friday): D22 


For Librarians Use Only 


Number Dl 61 

Date. 

Entered by 

Checked by 


Section A - Total Hours Spent on Maintenance (includes time spent on an maintenance 

activities tor the project excluding wnting specification modifications) 


Section B — Hours By ClBSS of MBintenance (Total of hours in Section B should equal total hours i 
Section A) 



Class 

Definition 

Hours 

Correction 

Hours spent on all maintenance associated with a system failure. 

Dl 51 

Enhancement 

Hours spent on all maintenance associated with modifying the system due 
to a requirements change. Includes adding, deleting, or modifying system 
features as a result of a requirements change. 

D152 

Adaptation 

Hours spent on all maintenance associated with modifying a system to 
adapt to a change in hardware, system software, or environmental 
characteristics. 

Dl 53 

Other 

Other hours spent on the project (related to maintenance) not covered 
above. Includes management, meetings, etc. 

Dl 54 

Section C — Hours By MsintenBnce Activity (Total of hours in Section C should equal total hours in 

Section A) 

Activity 

Activity Definitions 

Hours 

Isolation 

Hours spent understanding the failure or request for enhancement or 
adaptation. 

D155 

Change 

Design 

Hours spent actually redesigning the system based on an understanding 
of the necessary change. 

D156 

Implementation 

Hours spent changing the system to complete the necessary change. 
This includes changing not only the code, but the associated 
documentation. 

D157 

Unit Test/ 
System Test 

Hours spent testing the changed or added components. Includes hours 
spent testing the integration of the components. 

D158 

Acceptance/ 
Benchmark Test 

Hours spent acceptance testing or benchmark testing the modified 
system. 

Dl 59 

Other 

Other hours spent on the project (related to maintenance) not covered 
above. Includes management, meetings, etc. 

D160 


NOVEMBER 1991 


Figure C-14. Weekly Maintenance Effort Form (WMEF) 
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APPENDIX D— DATA DEFINITION LANGUAGE FOR THE 

SEL DATABASE 


This appendix describes the data definition language (DDL) that contains all the semantic 
rules of the SEL database. This DDL represents the design of the SEL database. It is not 
implementation language and should not be confused with Oracle s DDL statements in SQL. 

In the design DDL, each base relation is identified by the keyword RELATION and each 
view is identified by the keyword VIEW. Each field within a relation is identified by the 
keyword F IELD followed by its name, its data type, and its length. Char, which represents a 
character data type, is followed by the maximum length of the field. Numeric, which 
represents a numeric data type, is followed by the width of the field and the number of 
decimal places, if any. Date represents an ORACLE date data type. 

The primary key component(s) is identified by the keyword KEY. The keyword UNIQUE 
identifies fields that are not part of the primary key but whose values are unique within a 
relation. The keyword INDEX identifies fields that are not unique, but should be indexed to 
facilitate database retrievals. 

The constraints mentioned in Section 4.2.3 are represented by mathematical expressions. 
The following constraint in the DDL 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ.SUB S 

VS HP (P.PROJ_NO = S.PROJ_NO) 

can be interpreted as follows: P is the range variable that ranges over the PROJECT relation, 
and its permitted values are records of PROJECT. S is the range variable that ranges over the 
PROJ_SUB relation, and its permitted values are records of PROJ_SUB. Here, range vari- 
ables are used as a simple shorthand. For all (V) S, there exists (3) P such that PROJ_NO in P 
is equal to PROJ_NO in S. In other words, for each project number that exists in the 
project— subsystem relation, the same project number must exist in the project relation. 
Besides “for all” (V) and “there exist” (3) qualifiers, the qualifier “or” (V) is used in the 
constraint definition of relation EFF_ACT, and the qualifier “and” A is used in the constraint 
definitions of relations CH_ERR_ARES , CH_ERR_TOOLS, CH_ADAFEAT, and 
CH_ERR_GEN . Each field within a view is identified by the keyword FIELD followed by 
its name and the base relation from which it is derived. The field lengths are the same as in the 
base relations. 
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RELATION CHANGE 

(FIELD CHANGE_NO char (6) 

FIELD PROGJQD numeric(5) 

FIELD SUB_DATE date 
FIELD EFF_ONE char(l) 

FIELD EFF ADA char(l) 

HELD EFF_ISO_CH char(10) 

HELD EFF_COM_CH char(IO) 

HELD EFF PARPA char(l) 

HELD EFF_OTHER char(l) 

HELD DATE_DETER date 
HELD DATE_COMP date 
HELD NUM_COM_CH numeric(2) 

HELD NUM_COM_EX numeric(2) 

HELD CH_TYPE char(10) 

HELD FORM_TYPE char(6) 

HELD STATUS char(10)) 

KEY (CHANGE.NO) 

INDEX (SUB _D ATE) 

INDEX (PROG_ID) 

INDEX (CH_TYPE) 

INDEX (STATUS) 

CONSTRAINT 

RANGE VAL_ISO_CH VEI 
RANGE CHANGE CH 
RANGE PERSONNEL PROG 
RANGE VAL_STATUS VS 
RANGE VAL_EFF_COM_CH VEC 
RANGE VAL_CH_TYPE VCHT 

VCH 3PROG (PROG.PROG_ID = CH.PROG_ID) 
VCH 3VS (VS.CODE = CH.STATUS) 

VCH 3 VEI (VEI.CODE = CH.EFF_ISO_CH) 

VCH 3 VEC (VEC. CODE = CH.EFF_COM_CH) 
VCH 3VCHT (VCHT.CODE = CH.CH_TYPE) 
VCH 3CH (CH.FORM_TYPE = ‘CRF’) 
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RELATION CHANGE_COM 

( FIELD CHANGE_NO char(6) 
FIELD COM_NO numeric(7)) 


KEY (CHANGE_NO, COM_NO) 


INDEX (COM_NO) 

CONSTRAINT 

RANGE SUB_COM C 
RANGE CHANGE_COM CHC 
RANGE CHANGE CH 

VCHC 3C (C.COM_NO = CHC.COM_NO) 

VCHC 3CH (CH.CHANGE_NO = CHC.CHANGE.NO) 


RELATION CH.ADAFEAT 

( FIELD CHANGE_NO char(6) 

FIELD ADA_FEATURE char(10)) 

KEY (CHANGE_NO, ADA_FEATURE) 

CONSTRAINT 

RANGE CHANGE CH 
RANGE CH_ADAFEAT CHA 
RANGE VAL_ADA_FEATURE VAF 

VCHA 3VAF (VAF.CODE = CHA.ADA_FEATURE) 

VCHA 3CH (CH.EFF_ADA = ‘ Y ’ A CH.CHANGE_NO = 

CHA.CHANGE_NO A CH.CH.TYPE = ERRCO’) 


RELATION CH_ERR_ARES 

f FIELD CHANGE_NO char(6) 

FIELD ERR_ARES char(10)) 

KEY (CHANGENO, ERR_ARES) 

CONSTRAINT 

RANGE CHANGE CH 
RANGE CH_ERR_ARES CHEA 
RANGE VAL_ERR_ARES VEA 

VCHEA 3CH (CH.CH_TYPE = ‘ERRCO’ A CH.CHANGE_NO = 
CHEA.CHANGE_NO A CH.EFF ADA = ‘Y’) 

VCHEA 3 VEA (VEA.CODE = CHEA.ERR_ARES) 
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RELATION CH_ERR_GEN 

(FIELD CHANGE_NO char(6) 

FIELD ERRSOURCE char(10) 

FIELD ERR_CLASS char(10) 

FIELD ERR_COMIS char(l) 

FIELD ERR_TYPO char( 1 ) 

FIELD ERR_OMIS chard) 

HELD ERR_ADOC char(l) 

FIELD ERR_ACAUSE chard 0)) 

KEY (CHANGE_NO) 

INDEX (ERR_ACAUSE) 

CONSTRAINT 

RANGE CHANGE CH 
RANGE CH_ERR_GEN CHEG 
RANGE VAL_ERR_SOURCE VES 
RANGE VAL_ERR_CLAS S VEC 
RANGE VAL_ERR_ AC AU S E VERA 

VCHEG 3CH (CH.CH_TYPE = ‘ERRCO’ A CH.CHANGE_NO 
CHEG.CHANGE_NO) 

VCHEG 3 VES (VES.CODE = CHEG.ERR_SOURCE) 

VCHEG 3 VERA (VERA.CODE = CHEG.ERR_ACAUSE) 

VCHEG 3 VEC (VEC.CODE = CHEG.ERR_CLASS) 

RELATION CH_ERR_TOOLS 

(FIELD CHANGE_NO char(6) 

FIELD ERR_TOOLS char(10)) 

KEY (CHANGE_NO, ERR_TOOLS) 

CONSTRAINT 

RANGE CHANGE CH 
RANGE CH_ERR_TOOLS CHET 
RANGE VAL_ERR_TOOLS VET 

VCHET 3CH (CH.CH_TYPE = ERRCO’ A CH.CHANGE_NO 
CHET.CHANGE_NO) 

VCHET 3VET (VET.CODE = CHET.ERR_TOOLS) 
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RELATION COMPUTER 

(FIELD CPU_NAME char( .10) 

HELD C_FULL_NAME char(20)) 

KEY (CPU_NAME) 

RELATION COM_PURPOSE 

(FIELD COM_NO numeric(7) 

FIELD PURPOSE char( 10)) 

KEY (COM_NO, PURPOSE) 

CONSTRAINT 

RANGE COM_SOURCE C 
RANGE COM_PURPOSE CP 
RANGE VAL_COM_PURPOSE_VCOP 

VCP 3C (C.COM_NO = CP.COM_NO) 

VCP 3VCOP (VCOPCODE = CP.PURPOSE) 

RELATION COM_SOURCE 

(FIELD COM_NO numeric(7) 

FIELD PROG_ID numeric(5) 

FIELD FORM_NO char(6) 

FIELD FORM_TYPE char(6) 

FIELD STATUS char(10) 

FIELD CREATE_DATE date 
FIELD ORI_TYPE char(IO) 

HELD COM_TYPE char(10) 

HELD DIFFICULTY numeric(2) 

HELD SUB_DATE date) 

KEY (COM_NO) 

UNIQUE (FORM_NO) 

INDEX (FORM_NO) 

INDEX (STATUS) 

INDEX (CREATE_DATE) 

INDEX (SUB_DATE) 

CONSTRAINT 

RANGE SUB_COM C 
RANGE COM SOURCE CSO 
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RANGE VAL_ORI_TYPE VOT 
RANGE VAL_STATUS VS 
RANGE VAL_COM_TYPE VCT 
RANGE PERSONNEL PROG 

VCSO 3C (C.COM_NO = CSO.COM_NO) 

VCSO 3 VOT (VOT. CODE = CSO.ORI_TYPE) 

VCSO 3 VS (VS. CODE = CSO.STATUS) 

VCSO 3VCT (VCT. CODE = CSO.COM_TYPE) 

VCSO 3PROG (PROG.PROG_ID = CSO.PROG_ID) 

VCSO 3CSO (CSO.FORM_TYPE = ‘COF’) 

RELATION COM_STAT 

(FIELD COM_NO numeric(7) 

FIELD C_EXE_S numeric (6) 

FIELD C_LINE numeric(6) 

FIELD C_C_LINE numeric(6) 

FIELD C_STMTS numeric(6) 

FIELD FTNAL_ORIGIN_CAT char(10)) 

KEY (COM_NO) 

CONSTRAINT 

RANGE SUB_COM C 
RANGE COM_STAT CS 

VCS 3C (C.COM_NO = CS.COM_NO) 

RELATION CRF_TEMP_CHANGE_COM 
(FIELD USER ID numeric 
FIELD SUB_PRE char(5) 

FIELD COM_NAME char(40) 

FIELD COM_NO numeric(7)) 

KEY (USER_ID, SUB_PRE, COM_NAME) 

CONSTRAINT 

RANGE V_PROJ_COM VPROJ 
RANGE CRF_TEMP_CHANGE_COM CRF 
RANGE PROJ_SUB SUB 

VCRF 3SUB (SUB.SUB_PRE = CRF.SUB_PRE) 

VCRF 3 VPROJ (VPROJ.COM_NAME = CRF.COM_NAME) 
VCRF 3 VPROJ (VPROJ.COM_NO = CRF.COM_NO) 
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RELATION DSF_MEASUR£ 

( HELD D_ID numeric(lO) 

FIELD STATUS_CODE char(10) 

FIELD MEASURE_CODE char(10) 

FIELD MEASURE_VALUE numeric(5)) 

KEY (D_ID, STATUS _CODE, MEASURE_CODE) 
CONSTRAINT 

RANGE VAL_DSF_TARGET VDT 
RANGE VAL_DSF_MEASURE VDM 
RANGE PROJ_DSF DSF 
RANGE DSF_MEASURE DM 

VDM 3 VDT (VDT. CODE = DM.MEASURE_CODE) 
VDM 3 VDM (VDM.CODE = DM.STATUS_CODE) 
VDM 3DSF (DSF.DJD = DM.DJD) 

RELATION DSF_TARGET 

( FIELD D_ID numeric! 10) 

FIELD STATUS_CODE char(10) 

FIELD TARGET_CODE char( 10) 

FIELD TARGET_VALUE numeric(5)) 

KEY (DJD, STATUS _CODE, TARGET_CODE) 

CONSTRAINT 

RANGE VAL_DSF_TARGET VDT 
RANGE VAL_DSF_STATUS VDS 
RANGE PROJ_DSF DSF 
RANGE DSF_TARGET DT 

VDT 3 VDT (VDT.CODE = DT.TARGET_CODE) 
VDT 3 VDS (VDS. CODE = DT. STATUS JTODE) 
VDT 3DSF (DSF.DJD = DT.D_ID) 

RELATION DUMMY 

(HELD HIDDEN char(l )) 

RELATION EFF_ACT 

( HELD EFFJD numeric! 10) 

HELD ACTIVITY char(10) 

HELD ACT_HR numeric 10, 2)) 
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KEY (EFFJD, ACTIVITY) 
CONSTRAINT 


RANGE EFF_PROJ EP 
RANGE EFF_SUB ES 
RANGE VAL_ACnVITY VA 
RANGE EFF_ACT EA 

VEA 3VA (VA.CODE = EA. ACTIVITY) 

VEA 3EP ES (ES.PSJD = EA.EFFJD 
EP.PID = EA.EFFJD) 

RELATION EFF_FORM 

(FIELD PJD numeric! 10) 

FIELD FORM_NO char(6) 

FIELD FORM_TYPE char(6) 

FIELD STATUS char(10)) 

KEY (PJD) 

INDEX (STATUS) 

INDEX (FORM_NO) 

CONSTRAINT 

RANGE EFF_PROJ EP 
RANGE EFF_FORM EFF 
RANGE VAL_STATUS VS 

VEFF 3EP (EP.P_ID = EFF.P JD) 

VEFF 3VS (VS.CODE = EFF.STATUS) 

VEFF 3EFF (EFF.FORM_TYPE = ‘SPF’ V EFF.FORMJYPE = ‘PRF’) 

RELATION EFF_PROJ 

(HELD PROJ_NO numeric(3) 

FIELD SUB _D ATE date 
FIELD PROG JD numeric(5) 

FIELD PJD numeric! 10)) 

KEY (PROJ_NO, SUB_DATE, PROG_ID) 

UNIQUE (P_ID) 

INDEX (P_ID) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PERSONNEL PROG 
RANGE EFF_PROJ EP 
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VEP 3P (P.PROJ_NO = EP.PROJ_NO) 

VEP 3PROG (PROG.PROGJD = EP.PROGJD) 
VEP 3EP (EP.SUB_DATE = a valid Friday date) 


RELATION EFF_SUB 

(FIELD P_ID numeric(lO) 

FIELD SUB_PRE char(5) 

FIELD PS_ID numeric(lO)) 

KEY (PJD, SUB_PRE) 

UNIQUE (PS_ID) 

INDEX (PSJD) 

GONSTRAINT 

RANGE EFF_PROJ EP 
RANGE EFF_SUB ES 
RANGE PROJ_SUB S 

VES 3S (S.SUB_PRE = ES.SUB_PRE) 
VES 3EP (EP.PJD = ES.PJD) 

RELATION GENERATE_S AT_D AY 

(FIELD SCRJPT_NO numeric(lO) 

FIELD SAT_DAY date) 

KEY (SCRIPT_NO, SAT_DAY) 


RANGE TEMP_SCRIPT T 
RANGE GENERATE_SAT_DAY SAT 

VSAT 3T (T.SCRIPT_NO = SAT.SCRIPT_NO) 

VS AT 3SAT (SAT.SAT_DAY = a valid Saturday date) 


RELATION MAINT_ACT_HRS 

(FIELD MAINTJD numeric(lO) 
FIELD MAINT_ACT char(10) 
FIELD ACT_HR numeric(10, 2)) 
KEY (MAINTJD, MAINT_ACT) 
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CONSTRAINT 

RANGE MAINT_ACT_HRS MAH 
RANGE MAINT.PROF MP 
RANGE VAL_ACT VA 

VMAH 3VC (VA.CODE = MAH.MAINT_ACT) 
VMAH 3MP (MP.MAINTJD = MAH.MAINT_ID) 

RELATION MAINT_CHANGE 

(FIELD MAINT_CH_NO char(6) 

FIELD PROJ_NO numeric(3) 

FIELD PROG_ID numeric(5) 

FIELD SUB_DATE date 
FIELD OSMR_NO numeric(4) 

HELD STATUS char(10) 

HELD FORM_TYPE char(6) 

FIELD MAINT_CH_TYPE char(10) 

FIELD CH_CAUSE char(10) 

HELD MAINT_ISO_CH char(10) 

FIELD MAINT_COM_CH char(10) 

FIELD CH_CLASS char(10) 

FIELD EST_LOC_ADD numeric(6) 

FIELD EST_LOC_CH numeric(6) 

FIELD ESTLOC-DEL numeric(6) 

FIELD COMP_ADD numeric(4) 

FIELD COMP_CH numeric(4) 

FIELD COMP_DEL numeric(4) 

FIELD COMP_ADD_NEW numeric(4) 

FIELD COMPADDREUSE numeric(4) 

FIELD COMP_ADD_REMOD numeric(4) 

KEY (MAINT_CH_N O) 

INDEX (PROJ_NO) 

CONSTRAINT 

RANGE MAINT_CHANGE MC 
RANGE VAL_MAINT_CH_TYPE VMCT 
RANGE VAL_CH CAUSE VCHC 
RANGE PROJECT P 
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RANGE VAL_STATUS VS 
RANGE PERSONNEL PROG 
RANGE VAL_MALNT_ISO_CH VMIC 
RANGE VAL.MAINT.COM.CH VMCC 
RANGE VAL _C H_CLASS VCC 

VMC BP (P.PROJ.NO = MC.PROJ_NO) 

VMC 3PROG (PROG.PROGJD = MC.PROGJD) 

VMC 3VS (VS. CODE = MC.STATUS) 

VMC BMC (MC.FORM_TYPE = ‘MCRF’) 

VMC 3VMCT (VMCT.CODE = MC.MAINT.CH.TYPE) 

VMC 3VCHC (VCHC.CODE = MC.CH_CAUSE) 

VMC 3 VMIC (VMIC.CODE = MC.MAINT_ISO_CH) 

VMC 3 VMCC (VMCC. CODE = MC.MAINT_COM_CH) 

VMC 3VCC (VCC.CODE = MC.CH_CLASS) 

VMC BMC (SUM(MC.COMP.ADD) = 

SUM(MC.COMP_ADD_NEW+ 

MC.COMP.ADD.REUSE+ 

MC.COMP_ADD_REMOD)) 

RELATION MALNT_CH .OBJECTS 

( FIELD MAINT_CH_NO char(6) 

FIELD CH.OBJECT char(10)) 

KEY (MAINT_CH_NO, CH.OBJECT) 

CONSTRAINT 

RANGE MAINT.CH.OBJECTS MCO 
RANGE VAL.C H_OB JECT VCO 
RANGE MAINT.CHANGE MC 

VMCO 3VCO (VCO.CODE = MCO. CH.OBJECT) 

VMCO BMC (MC.MAINT_CH_NO = MCO.MAINT_CH.NO) 

RELATION M AINT.C LAS S _HRS 

I FIELD MAINT.ID numeric( lO) 

FIELD MAINT CLASS char(10) 

FIELD CLASS.HR numeric! 10. 2)) 

KEY (MAINT.ID, MAINT.CLASS) 
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CONSTRAINT 

RANGE MAINT_CLASS_HRS MCH 
RANGE MAINT_PROJ MP 
RANGE VAL.CLASS VC 

VMCH 3VC (VC. CODE = MCH.MAINT_CLASS) 
VMCH BMP (MP.MAINTJD = MCH.MAINTID) 

RELATION MAINT_PROJ 

( FIELD PROJ_NO numenc(3) 

FIELD SUB_DATE date 
FIELD PROG_ID numeric(5) 

FIELD MAINT_ID numeric( 10) 

HELD FORM_NO chart 6) 

FIELD FORM_TYPE char(6) 

FIELD STATUS chart 10)) 

KEY (PROJ_NO. SUB_DATE. PROG_ID) 

UNIQUE (MALNT _ID) 

INDEX (MAINT_ID) 

INDEX (FORM_NO) 

CONSTRAINT 

RANGE MAINT_PROJ MP 
RANGE PROIECT P 
RANGE VAL_STATUS VS 
RANGE PERSONNEL PROG 

VMP BP (PPROJ_NO = MP.PROJ_NO) 

VMP 3PROG (PROG.PROGJD = MP.PROGJD) 
VMP 3 VS (VS .CODE = MP.STATUS) 

VMP BMP (MP.SUBDATE — a valid Friday date) 
VMP BMP (MP.FORM_TYPE = ‘WMEF’) 

RELATION PC_SEQNO 

(FIELD TABLE_NAME charOO) 

FIELD FIELD_NAME char(30) 

FIELD MAX_SEQNO numeric! 10)) 

KEY (TABLE JMAME. FIELD_NAME) 
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CONSTRAINT 

RANGE PC SEQNO S 

VS 3S <S.TABL£_NAME = a valid relation name 

A S.FIELD_NAME = a valid field name within that 
relation) 

RELATION PERM_SCR3PT 

( FIELD ORA_USER chan 20) 

FIELD SCRJPT_NAME chan 20) 

FIELD SCRIPT_NO numeric! 10)) 

FIELD OUT_ROUTTNG char(20) 

FIELD OUT_FILE chart 20) 

KEY (ORA_USER, SCRIPT_N AME) 

UNIQUE (SCRJPT_NO) 

INDEX (SCRIPT _NO) 

CONSTRAINT 

RANGE USER_CLASS U 
RANGE PERM _SCRIPT P 

'VP 3U (U.ORAJJSER = P.ORAJJSER) 

VP 3P ((P.OUT_ROUTTNG = ‘2’) 

A (P.OUT_FILE != null A 
P.OUT_ROUTING = ’ 1’)) 


RELATION PERSONNEL 

( FIELD PROG_iD numeric) 5) 
FIELD FORM_NAME chart L5) 
FIELD FULL_NAME chart 30) 
FIELD DATE_ENTRY date) 
KEY (PROG_lD) 

UNIQUE (FORM_NAME) 

INDEX ( FORM _N AME) 


RELATION PROJECT 

( HELD PROJ .NAME chart 8) 

HELD PROJ_NO numeric) 3) 

HELD PROJ_TYPE chart 10)) 
( HELD ACTIVE .STATUS chart 10)) 
KEY (PROJ_NAME) 

UNIQUE (PROJ NO) 

INDEX (PROJ NO) 
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RELATION PROJ_CPU_STAT 

(FIELD PROJ_NO numeric! 3) 

FIELD SUB _DATE date 
FIELD CPU_NAME chart 10) 

FIELD TOTAL HRS numeric! 10,2) 

FIELD T_RUN numeric(6)) 

KEY (PROJ_NO. SUB_DATE, CPU_NAME) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_EST_CPU PESC 
RANGE COMPUTER_CPU 

VPESC 3P (P.PROJ_NO = PESC.PROJ_NO) 

VPESC 3CPU (CPU.CPU.NAME = PESC.CPU_NAME) 

RELATION PROJ_DSF 

( FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 
FIELD PROG_ID ntuneric(5) 

FIELD FORM_NO char! 6) 

FIELD STATUS char(10) 

FIELD FORM_TYPE char(6) 

FIELD DJD numeric! 10)) 

KEY (PROJ_NO. SUB_DATE) 

UNIQUE (DJD) 

UNIQUE (FORM_NO) 

INDEX (DJD) 

INDEX (FORM_NO) 

CONSTRAINT 

RANGE VAL_STATUS VDS 
RANGE PERSONNEL PROG 
RANGE PROJECT P 
RANGE PROJ_DSF_PD 

VPD 3P (P.PROJ_NO = PD. PROJ_NO) 

VPD 3PROG ( PROG. PROG JD = PD.PROG JD) 

VPD 3PD (PD.SUB_DATE = a valid Friday date) 

VPD 3VDS < VDS.CODE = PD.STATUS) 

VPD 3PD (PD.FORM_TYPE = DSF’) 
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RELATION PROJ_EST 

(FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 
FIELD T_SYS numeric(4) 

FIELD T_COM numeric(4) 

FIELD T_LINE numeric(7) 

FIELD T_NEW_LINE numeric(7) 

FIELD T_MOD_LINE numeric(7) 

FIELD T_OLD_LENE numeric(7) 

FIELD PRO_HR numeric(10,2) 

FIELD MAN_HR numeric(l0,2) 

FIELD SER_HR numeric! 10,2) 

KEY (PROJ_NO, SUB_DATE) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_EST PES 

VPES 3P (P.PROJJMO = PES.PROJ_NO) 

RELATION PRO J_EST_P H AS E 

(FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 
FIELD PHASE_CO char(10) 

FIELD START_DATE date 
FIELD END_DATE date) 

KEY (PROJ_NO, SUB_DATE, PHASE_CO) 

CONSTRAINT 

RANGE PROJECT P 

RANGE PROJ_EST_PHASE PESP 

RANGE VAL_PHASE_CO VPC 

VPESP 3P (P.PROJ_NO = PESP.PROJ_NO) 

VPESP 3 VPC (VPC. CODE = PESP.PHASE_CO) 

VPESP 3PESP (PESP.START_DATE = a valid Saturday date) 
VPESP 3PESP (PESP.END_DATE = a valid Saturday date) 
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RELATION PROJ_FORM 

(FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 
FIELD FORM_NO char(6) 

HELD FORM_TYPE char(6) 

HELD STATUS char(10)) 

KEY (PROJ_NO, SUB_DATE, FORM_TYPE) 

UNIQUE (FORM_NO, FORM_TYPE) 

INDEX (FORM_TYPE) 

INDEX (STATUS) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_FORM PF 
RANGE VAL_STATUS VS 

VPF 3P (P.PROJ_NO = PF.PROJ_NO) 

VPF 3VS (VS. COD = PF.STATUS) 

VPF 3PF (PF.FORM_TYPE = ‘PEF’ V PF.FORM_TYPE 
‘SPF’ V PF. FORM_TYPE = ‘PCSF’ V 
PF. FORM_TYPE = ‘SEF’) 


RELATION PROJ GRH 

(FIELD PROJ_NO numeric(3) 

HELD SUB_DATE date 
HELD GR_LINE numeric(7) 

HELD GR_MOD numeric(4) 

HELD GR_CH numeric(6)) 

KEY (PROJ_NO, SUB_DATE) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ.GRH PG 

VPG 3P (P.PROJ_NO = PG.PROJ_NO) 

VPG 3PG (PG.SUB_DATE = a valid Friday date) 

RELATION PROJ_MESSAGES 
(FIELD S_ID numeric(5) 

HELD LINE_NO numeric (3) 

HELD MESSAGES char (65) 

HELD SUB_DATE date) 
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KEY (S_ID, LINE_NO) 

CONSTRAINT 

RANGE PROJ_NOTES PN 
RANGE PROJ_MESSAGES PM 

VPN 3PM (PM.S_ID = PN.S_ID) 

RELATION PROJ_NOTES 

(FIELD PROJ_NO numeric(3) 

FIELD NOTE_TYPE char(10) 

FIELD S_ID numeric(5)) 

KEY (PROJ_NO, NOTE.TYPE) 

UNIQUE (SJD) 

INDEX (S_ID) 

CONSTRAINT 

RANGE PROJECT P 

RANGE VAL_N OTE_TYPE VNT 

RANGE PROJ_NOTES PN 

VPN 3P (P.PROJ_NO = PN.PROJ_NO) 

VPN 3VNT_(VNT.CODE = PN.NOTE_TYPE) 

RELATION PROJ_PROD 

(FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 
FIELD RES_NAME char(10) 

FIELD RES_HR numeric(10,2) 

FIELD RES_RUN numeric(5)) 

KEY (PROJ_NO, SUB_DATE, RES_NAME) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ.PROD PR 
RANGE COMPUTER CPU 

VPR 3P (P.PROJ_NO = PR.PROJ_NO) 

VPR 3CPU (CPU.CPU_NAME = PR.RES_NAME) 
VPR 3PR (PR.SUB_DATE = a valid Friday date) 
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RELATION PROJ_SEF 

( FIELD PROJ_NO numeric(3) 

FIELD MEAS_TYPE char(10) 

FIELD EVALUATE numerical )) 

KEY (PROJ_NO, MEAS_TYPE) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_SEF PSE 
RANGE VAL_MEAS_TYPE VMT 

VPSE 3P (P.PROJ_NO = PSE.PROJ_NO) 

VPSE 3VMT_(VMT.CODE = PS E.MEAS_TYPE) 

RELATION PRO J_S EF_S EC 

( FIELD PROJ_NO numeric(3) 

FIELD MEAS_TYPE char(10) 

FIELD SECOND_L char(10)) 

KEY (PROJ_NO, MEAS_TYPE, SECOND_L) 

CONSTRAINT 

RANGE PROJ_SEF_SEC PSES 
RANGE PROJ_SEF PSE 
RANGE VAL_SEC_L VSL 

VPSES 3PSE (PSE.MEAS_TYPE = PSES.MEAS_TYPE A 
PSE.PROJ_NO = PSES.PROJ_NO) 

VPSES 3 VSL (VSL.CODE = PSES .SECOND L) 

RELATION PROJ_STAT 

( FIELD PROJ_NO numeric(3) 

FIELD SUB_DATE date 

FIELD TECH_MAN_HR numeric(10,2) 

FIELD SER_HR numeric(10,2) 

FIELD T SYS numeric(4) 

FIELD T_COM numeric(4) 

FIELD T_CH numeric(6) 

FIELD T DOC numeric(6) 

FIELD T_LINE numeric(7) 
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FTFT n T_NEW JJNE numeric(6) 

FTFT D T_MOD_UNE numeric(6) 

FIELD T_OLD_LINE numeric(6) 

FTELD T_COMMENT numeric(6) 

FIELD T_EXE_MOD numeric(4) 

FIELD T_NEW_MOD numeric(4) 

FTFT D T_MOD_MOD numeric(4) 

FTELD T_OLD_MOD numeric(4) 

FIELD T_EXE_STAT numeric(6) 

FTFT D T_NEW_STAT numeric(6) 

FIELD T_MOD_STAT numeric(6) 

FTFT D T_OLD_STAT numeric(6) 

FIELD T_STMTS numeric(6) 

FIELD T_NEW_STMTS numeric(6) 

FTFT ,n T_MOD_STMTS numeric(6) 

FTFT D T_OLD_STMTS numeric(6)) 

FTF.T D T_EXTMO_LINE numeric(6) 

FTELD T EXTMO MOD numeric(4) 

FIELD T_EXTMO_STAT numeric(6) 

FIELD T_EXTMO_STMTS numeric(6)) 

KEY (PROJ_NO) 

CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_EST PES 

VPES 3P (P.PROJ_NO = PES.PROJ_NO) 

RELATION PROJ_SUB 

(FIELD PROJ_NO numeric(3) 

FIELD SUB_PRE char(5) 

FIELD SUB_DATE date 
RELD SUBSYJD numeric(5)) 

KEY (PROJ_NO, SUB_PRE) 

UNIQUE (SUBSYJD) 

INDEX (SUBSYJD) 
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CONSTRAINT 

RANGE PROJECT P 
RANGE PROJ_SUB S 

VS 3P (P.PROJ_NO = S.PROJ_NO) 

RELATION REP_CODES 

(FIELD CODE char(10) 

FIELD VALUE char(30) 

FIELD FUNCTION char(15)) 

KEY (CODE) 

RELATION SCRIPT_PROJECTS 

(FIELD SCRIPT_NO numeric(lO) 

FIELD REPORT SEQ numeric(3) 

FIELD PROJ_NAME char(8)) 

KEY (SCRIPT_NO, REPORT_SEQ, PROJ_NAME) 
CONSTRAINT 

RANGE PROJECT PR 
RANGE SCRIPT_REPORT R 
RANGE SCRIPT_PROJECTS P 

VP 3R (R.SCRIPT_NO = P.SCRIPT_NO A 

R.REPORT_SEQ = P.REPORT_SEQ) 

VP 3PR (PR.PROJ_NAME = P.PROJ_NAME) 

RELATION SCRIPT_REPORT 

( FIELD SCRJPT_NO numeric(lO) 

FIELD REPORT_SEQ numeric(3) 

FIELD REPORT_CODE char(10) 

FIELD REPORT_TYPE char(20) 

FIELD REPORT_TYPE_SELECTION char(10)) 

KEY (SCRIPT_NO, REPORT_SEQ) 

CONSTRAINT 

RANGE PROJECT PROJ 
RANGE PERM SCRIPT P 
RANGE TEMP SCRIPT T 
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RANGE SCRIPT_REPORT S 
RANGE VAL_REPORT_CODE VAL 

VS P T (P.SCRIPT_NO = S.SCRIPT.NO 

T.SCRIPT_NO = S.SCRIPT_NO) 

VS VAL (VAL.REPORT_CODE = S.REPORT_CODE) 

VS PROJ ((S.REPORT_TYPE SELECTION = ‘INACTIVE’ 

V S.REPORT.TYPE SELECTION = ‘ACT_MAINT’ 

V S.REPORT_TYPE SELECTION = ‘ACT_DEV’ 

V S.REPORT_TYPE SELECTION = ‘ALL’ 

V S.REPORT_TYPE SELECTION = ‘LIST’) 

A S.REPORT_TYPE = ‘M’) V 

( (S .REPORT.TYPE.SELECTION = null) 

A (S.REPORT_TYPE = ‘O’)) V 

(S.REPORT_TYPE SELECTION = PROJ.PROJ_NAME A 

S.REPORT.TYPE = ‘S’) 

RELATION SEQNO 

(FIELD TAB LE.NAME char(30) 

FTF.T D FIELD.NAME char(30) 

FIELD MAXSEQNO numeric(lO)) 

KEY (TAB LE_N AME , FIELD.NAME) 

CONSTRAINT 

RANGE SEQNO S 

VS 3S (S .TAB LE_N AME = a valid relation name 

S. FIELD.NAME = a valid field name within that 
relation) 

RELATION SPECIAL ACT 

(FIELD EFF.ID numeric(lO) 

(FIELD SP.ACTTVITY char(10) 

FIELD ACT.HR numeric(10, 2)) 

KEY (EFF.ID, SP.ACTTVITY) 

CONSTRAINT 

RANGE SPECIAL. ACT SA 
RANGE EFF.PROJ EP 
RANGE EFF SUB ES 
RANGE VAL.SP.ACTTVTTY VAL 

VSA 3EP ES (EP.P.ID = SA.EFF.ID 
ES.PS.ID = SA.EFF.ID) 

VSA 3 VAL (VAL.SP.ACTTVITY = SA.SP.ACITVITY) 
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RELATION SUBSYSTEM 

(FIELD SUBSY_ID numeric(5) 

FIELD NAME char(40) 

HELD FUNCTION char(10)) 

KEY (SUBSYJD) 

CONSTRAINT 

RANGE PROJ_SUB S 
RANGE SUBSYSTEM SUB 
RANGE VAL S FUNCTION VSF 

VSUB 3S(S.SUBSYJD = SUB .SUBSYJD) 
VSUB 3 VSF (VSF.CODE = SUB. FUNCTION) 

RELATION SUB_COM 

(FIELD SUBSYJD numeric(5) 

FIELD COM_NAME char(40) 

FIELD COM_NO numeric(7) 

FIELD COM DATE date) 

KEY (SUBSYJD, COM_NAME) 

UNIQUE (COM_NO) 

INDEX (COM_NO) 

CONSTRAINT 

RANGE PROJ_SUB S 
RANGE SUB_COM C 

VC 3S (S.SUBSY JD = C.SUBSY JD) 

RELATION TAB LE_PRIVILEGE 

(FIELD TAB LE_NAME char(40) 

FIELD USER_CLASS char(20) 

FIELD SELECT J>RTV char( 1 ) 

FIELD INSERT_PRJV char(l) 

FIELD UP D ATE_PRIV char( 1 ) 

FIELD DELETE J>RIV char(l ) 

FIELD ALTER_PRTV char(l) 

FIELD INDEX J>RIV char(l)) 

KEY (TAB LE_N AME , USER_CLASS) 
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CONSTRAINT 

R ANGE TAB LE_PRTVILEGE T 
RANGE USER_CLASS U 

VT 3U (U.USER_CLASS = T.USER_CLASS) 

VT 3T_(T.TABLE_NAME = a valid relation in the database) 

RELATION TEMP_ACnVITY 

(FIELD ACTIVITY char(10) 

FIELD SAT_DAY date 
FIELD HOURS numeric! 10,2) 

FIELD PROJ_NO numeric(3) 

FIELD SUB_HR numeric! 10,2) 

FIELD FLAG char(4) 

FIELD SCRIPT_NO numeric! 10)) 

CONSTRAINT 

RANGE TEMP_ACTIVTTY TEMP 
RANGE G ENERATE_S AT_D AY GSAT 

VTEMP 3GSAT (GSAT.SCRIPT_NO = TEMP.SCRIPT_NO 
A GSAT.SAT_DAY = TEMP.SAT_DAY) 

RELATION TEMP_FORMCT 
(FIELD SUB_DATE date 
FIELD PROG_ID numeric!5) 

FIELD FORM_TYPE char(6) 

FIELD PROJ_NO numeric(3) 

FIELD SCRIPT_NO numeric! 10)) 

CONSTRAINT 

RANGE TEMP_FORMCT TEMP 
RANGE GENERATE_SAT_DAY GSAT 

VTEMP 3GSAT (GSAT.SCRIPT_NO = TEMP.SCRIPT_NO 
A GSAT. S AT_D AY = TEMP.SATJDAY) 

RELATION TEMP_MANHRS 

(FIELD FORM_NAME char(l5) 

FIELD SAT_DAY date 
FIELD HOURS numeric! 10,2) 


1 0004437L 


D-23 


FIELD PROJ_NO numeric(3) 

FIELD PROG_ED numeric(5) 

FIELD SUB_HR numeric(10,2) 

FIELD FLAG char(4) 

FIELD P_ID numeric(lO) 

FIELD SCRIPT_NO numeric(lO)) 

CONSTRAINT 

RANGE TEMP_MANHRS TEMP 
RANGE G ENERATE_S AT_D AY GSAT 

VTEMP 3GSAT (GSAT.SCRlPT_NO = TEMP.SCRIPT_NO 
A GSAT.SAT_DAY = TEMP.S AT_D AY ) 

RELATION TEMP_SCRIPT 

( FIELD SCRIPT_NO numeric(IO) 

HELD ORA_USER char(20) 

HELD PROCESS_ID char(20) 

HELD OUT_ROUTING chai(20) 

HELD OUT_HLE char(20) 

HELD R UN_STATU S char(10) 

HELD DELETE_STATUS char(10)) 

KEY (SCRJDPT_NO) 

CONSTRAINT 

RANGE USER_CLASS U 
RANGE TEMP S CRIPT T 

VT 3U (U.ORA_USER = T.ORA_USER) 

VT 3T ( (T. OUT_RO UTIN G = ‘2’ V T.OUT_ROUTING = ‘ 
(T.OUT_HLE != nuO A T.OUT_ROUTING = T’)) 

RELATION TEMP_SERVHRS 

(FIELD FORM_NAME char(15) 

HELD SAT_DAY date 
HELD HOURS numeric(10,2) 

HELD PROJ_NO numeric(3) 

HELD PROG_ID numeric(5) 

HELD FLAG char(4) 

HELD P_ID numeric(lO) 
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FIELD SCRIPT_NO numeric(lO)) 

CONSTRAINT 

RANGE TEMP_S ERVHRS TEMP 
RANGE GENERATE_SAT_DAY GSAT 

VTEMP 3 GSAT (GSAT.SCRIPT_NO = TEMP.SCRIPT_NO 
A GSAT. S AT_D AY = TEMP.SAT_DAY) 

RELATION USER CLASS 

(FIELD ORA_USER_ID char(20) 

HELD USER CLASS char(20)) 

KEY (ORA_USER_ED) 

CONSTRAINT 

RANGE USER_CLASS_ACCESS UA 
RANGE USER_CLASS U 

VU 3U (U.ORA_USER_ID = a valid ORACLE user ID) 

VU 3UA (UA.USER_CLASS = U.USER_CLASS) 

RELATION USER CLASS ACCESS 
(FIELD USER CLASS char(20) 

FIELD ACCESS_TYPE char(10)) 

KEY (USER_CLASS, ACCESS_TYPE) 

CONSTRAINT 

RANGE USER_CLASS_ACCESS UA 
RANGE USER_CLASS U 

VU 3UA (UA.USER_CLASS = U.USER_CLASS) 

VUA 3UA (UA.ACCESS_TYPE = (‘BACKUP’ V ‘DBA’ 

V ‘DELETE’ V ‘DISTAPE’ V ‘FORM’ V ‘GENERAL’ 
V ‘IMPORT’ V ‘INSERT’ V ‘QA’ V ‘QUERY’ 

V ‘REPORT’ V ‘RESTORE’ V ‘UPDATE’ V ‘VIEW’)) 


RELATION VALIDATION 

(FIELD F_NAME char(20) 

FIELD CODE char(10) 

FIELD VALUE char(75)) 

KEY (F_NAME, CODE) 

VIEW AUTHORIZE 

( FIELD ACCESSJTYPE, SOURCE USER_CLASS_ACCESS 
FIELD ORA_USER_ID, SOURCE USER_CLASS) 
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VIEW VAL_ACTI VE_STATU S 

( FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ACTIVTTY 

( FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ADA_FEATURE 

(FIELD CODE, SOURCE VALIDATTON 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_CH_C AUS E 

(FIELD CODE, SOURCE VALIDATTON 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_CH_CLASS 

( FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_CH_OBJECT 

(FIELD CODE, SOURCE VALIDATTON 
HELP VALUE, SOURCE VALIDATION) 

VIEW VAL_CH_TYPE 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_CL ACTIVITY 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_COM_CH 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_COM_PURPOSE 

(HELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 
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VIEW VAL_COM_TYPE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_DATA_AVAIL 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_DSF_MEASURE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_DSF_STATUS 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_DSF_TARGET 

( FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ERR_ACAUSE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ERR_ARES 

( FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ERR_CLASS 

( FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ERR_SOURCE 

( FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ERR_TOOLS 

( FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 
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VIEW VAL_FTNAL_ORIGIN_CAT 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ISO_CH 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MAINT_ACT 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MAINT_CH_TYPE 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MAINT_CLASS 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MAINT_COM_CH 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MAINT_ISO_CH 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_MEAS_TYPE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_NOTE_TYPE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_ORI_TYPE 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 
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VIEW VAL_PHASE_CO 


AFIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_PROJ_TYPE 

(FIELD PROJ_NO, SOURCE PROJECT 
FIELD PROJ.TYPE, SOURCE PROJECT) 

VIEW VAL_QA_STATUS 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_REPORT_CODE 

(FIELD CODE, SOURCE VALIDATION 
HELD VALUE, SOURCE VALIDATION) 

VIEW VAL_SECOND_L 

(HELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_S_FUNCTTON 

(HELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_SP_ ACTIVITY 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW VAL_STATUS 

(FIELD CODE, SOURCE VALIDATION 
FIELD VALUE, SOURCE VALIDATION) 

VIEW V_CLEANROOM_ACT 

( FIELD EFF_ID, SOURCE EFF_ACT 
HELD ACTIVITY. SOURCE EFF_ACT 
HELD ACT_HR, SOURCE EFF_ACT) 
CONSTRAINT 

RANGE EFF_ACT_EA 
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RANGE V_CLEANROOM_ACT VCA 
RANGE VAL_CL_ACTIVITY VALA 

VVCA 3EA 3VALA (EA ACTIVITY LIKE ‘CL%’ A 

VALA.CODE = VCA.CL ACTIVITY) 

VIEW V_CLEANROOM_PROJECTS 

(FIELD PROJ_NAME, SOURCE PROJECT) 

VIEW V_PERM_S CRIPT 

( FIELD SCRIPT_NAME, SOURCE PERM_SCRIPT) 

VIEW V_PROJ_COM 

( FIELD PROJ_NAME, SOURCE PROJECT 
HELD SUB_PRE, SOURCE PROJ_SUB 
FIELD COM_NAME, SOURCE SUB_COM 
FIELD COM_NO, SOURCE SUB_COM) 

VIEW V_PROJ_SUB_ACT 

(FIELD PROJ_NAME, SOURCE PROJECT 
FIELD SUB_PRE, SOURCE EFF_SUB 
HELD ACTIVITY, SOURCE EFF_ACT 
FIELD ACT_HR, SOURCE EFF_ACT) 

VIEW V_REP_CODES_CRITERIA 

(FIELD VALUE, SOURCE REP CODES) 

VIEW V_SEQNO 

(FIELD TAB LE_NAME, SOURCE SEQNO 
FIELD FIELD_NAME, SOURCE SEQNO 
FIELD MAXSEQNO, SOURCE SEQNO) 

VIEW V_SUBSYSTEM_INFO 

(FIELD FUNCTION, SOURCE SUBSYSTEM 
FIELD NAME, SOURCE SUBSYSTEM 
FIELD PROJ_NAME, SOURCE PROJECT 
FIELD SUB_DATE, SOURCE PROJ_SUB 
FIELD SUB_PRE, SOURCE PROJ_SUB) 
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GLOSSARY 


Clause 

Cluster 


Column 

Command 

Field 

Group 

Index 


Join 

Null 

Order by 
Primary Key 

Query 

Record 

Relation 

Row 

Subquery 

Table 


View 


A portion of a SQL command, starting with a reserved word, that 
qualifies or constrains the operation of the command. 

An internal mechanism for storing together groups of related col- 
umns from different tables, or groups of like-valued column entries 
from a single table, to improve efficiency. (There are no clusters in the 
SEL database.) 

A particular class of data items within a table. Each column has a 
single value in each row of a table. Also called a field. 

An instruction to the SQL*Plus interpreter. 

Synonymous with column. 

A SQL*Plus function that operates on a single column of all rows in a 
query, returning a single value. 

A mechanism for improving efficiency of database access by enab- 
ling searches to be performed without always examining an entire 
table. 

Retrieval of related rows from two or more tables in a single query. 

A “value “ for a column indicating that the column has no value. Null 
values do not use storage space. 

A SQL clause that controls the order of displayed rows. 

A column or concatenation of columns whose values are frequently 
used to access a row of a table. 

An instruction to the SQL*Plus interpreter to retrieve one or more 
rows and columns from one or more tables or views. 

Synonymous with row. 

Synonymous with table. 

A single entry in a table, containing one entry for each column in the 
table. Also called a record. 

A query enclosed in parentheses that returns values used in a condi- 
tion of a SQL command. 

The basic unit of data storage in a relational DBMS. Contains a vari- 
able number of rows, each of which contains a fixed number of col- 
umns. Also called a relation. 

A “virtual table” that consists of one or more columns from underly- 
ing database tables. Views do not actually store data. 
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ABBREVIATIONS AND ACRONYMS 


AGSS 

Attitude Ground Support System 

CDR 

critical design review 

CLPRF 

Cleanroom Personnel Resources Form 

COF 

Component Origination Form 

CPU 

central processing unit 

CRF 

Change Report Form 

CSC 

Computer Sciences Corporation 

DAMSEL 

Database Access Manager for the Software Engineering Laboratory 

DBA 

database administrator 

DDL 

data definition language 

DSF 

Development Status Form 

ERRCO 

error correction 

FDF 

Flight Dynamics Facility 

GSFC 

Goddard Space Flight Center 

ID 

identification 

MCRF 

Maintenance Change Report Form 

NASA 

National Aeronautics and Space Administration 

OSMR 

Operational Software Modification Number 

PC 

personal computer 

PCSF 

Project Completion Statistics Form 

PDL 

program design language 

PDR 

preliminary design review 

PEF 

Project Estimates Form 

PMF 

Project Message Form 

PRF 

Personnel Resources Form 

PSF 

Project Startup Form 
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QA 

quality assurance 

RDBMS 

relational database management system 

SEF 

Subjective Evaluation Form 

SEL 

Software Engineering Laboratory 

SFR 

Software Failure Report 

SIF 

Subsystem Information Form 

SLOC 

source lines of code 

SPF 

Services/Products Form 

SQL 

structured query language 

STL 

Systems Technology Laboratory 

WMEF 

Weekly Maintenance Effort Form 
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